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iimcE 


This publication provides inforaation on how to iicorporate JES3 into an 

0S/TS2 Release 3 systea. It also contains inform ition that temporarily 

supplements other 0S/VS2 publications. 

This publication is divided into the following chapters: 

• D is t ribu tion T§£g, which describes the JSS3 independent component 
release (ICR) distribution tape. 

• I nstallati on Procedur e. which describes how to install JES3 in 0S/?S2 
Release 3. 

• S to r a ge Istiaates, which provides the information needed to estimate 
the amount of storage required for JES3. 

• Sy stem Banagem ep t Fac ilities Information , which describes the records 
written by JESS to the SHF data set and describes the space required 
for JESS SHF records. 

• C he c icpoi nt/Bes tart Inf orma ti on , which describes the checkpoint/- 
restart support for JES3. 

• Codes, which lists and explains completion codes issued by JESS and 
provides routing and descriptor codes inforaation associated with 
JESS messages. 

• Dyn ami c Support System Inferaa ion, which describes what must be done 
to allow DSS to operate in a J :S3 system. 

• Hi qr ation kid, whi' h contains all information related to 
functions, operation, messages and logic of this special aid 
provided with JES3 and ASP ver iion 3.1.7 and above. 

• JES3 Programming Not es and R es tr ic ti on s, which contains necessary 
information that may not be included in other publications. 

• Orde ring . fiistribution, and Pulli cat ions S up port. which provides the 
user with ordering and distrlbi. tion”procedures for the JES3 ICB, the 
basic and optional material lists, as well as the publications 
support for the JES3 ICR. 


S222i£22 Pu blicaticns 

The following publications contain specific JES3 information: 

• Operator’s Library: 0S/VS2 Reference {JSS3), GC38-0226 

• Operator’s Library: 0S/VS2 Rem )te Terminals (JES3), GC38-0228 

• 0S/ys2 System Programming Library: JES3 Debugging Guide, GC28-0703 

• 0S/VS2 System Programming Library: Initialization and Tuning Guide, 
GC28-0681 

• 0S/VS2 Introduction to JES3, GC28-0607 

• 0S/VS2 System Programming Library: JES3 Macro Instructions, GC38-0608 
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• 0S/VS2 System Progcaaiing Library: Job Banageiient, GC2tt-0627 

• 0S/VS2 JCL, GC28-0692 

• OS/VS Message Library: JES3 Messages, GC38-‘!012 

The following publications are referred to In the text: 

• OS/TS Checkpoint/Bestart, aC26-3784 

• OS/VS Dynaelc Support Systea, GC28-0640 

• 0S/7S Message Library: Routing and Cescriptor Codes, 6C38-1004 

• 0S/VS2 system Programming Library: Storage Estimates, GC28-0604 

• OS/?S Message Library: TS2 System Codes, GC38-1008 

• 0S/VS2 System Generation Hanuil, GC26-3792 

• OS/VS System Management Facil ties (SHF), GC35-0004 

• 0S/7S System Modification Pro/ram (SMP), GC28-0673 

• 0S/VS2 Scheduler and Supervisor Logic, SY28-0624,-0625,-0626 
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filST^lOOTifia T^Pg 


I The distribution tape for the independent conponent release of JES3 is 
I an unlabeled 9-tracli tape, written at either 1600 or 6250 BPl depending 
on which was ordered. The basic and optional distribution tapes consist 
of two files each, as follows: 


£isic 

• File 1, which contains the installation eacros, CB9926 and IBASa. 

For a description on how to code the CB9926 macro, see "Installation 
Macro Instruction". For this file, specify LRSCL=U0 and 
BLKSIZE=&00. These nacro instructions are required to create the job 
streaa for processing file 2. 

• File 2, which contains an unloaded partitioned data set with all the 
object nodules required for JSS3. 


O PTIOMAL 

• File 1, which contains JES3 source (synbolics) nodules in IE3UPDTE 
format as follows: 

./ ADD NAH-sI^Txxxx 

For this file specify LBECL=80 and Bl.KSlZE-8000. 

• File 2, which contains JES3 nacros (in ISBUPDTS format) as follows: 
./ ADD NAH£=nacro-naae 

For this file specify L5£CD=U0 and ELKSIZE=8000. 


Distribution Tape 7 
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IiiSTALbATION i-BOCSDUR: 


This chapter describes the preparation and procedure required to install 
JZS3 in a VS2, Release 3 system. The System Sodificacion Rroyram (SI.P) 
is used to install this indepenuent comconent release. For information 
on SKP, see 0S/V3 System Modification Program (SMP), GC2o-067J. 

Due to chanqes in the system jeneration macros, the SiiP.nSSTOSE function 
cannot be used durinq tne installation of JSS3. It is strongly 
recommended that you retain a bacii-up copy of your system ano 
distribution libraries. You can use the IIKDASD3 utility program to 
mahe a copy of your system and distribution libraries. 

The time required to run the entire installation procedure is 
apircximately 4 hours on the Model 15b. 


SISTEM AND DISTRIBUTICN LIB^HY HDfiUIRIMENTS 


Before JES3 can ne installed in your system, you must verify that there 
IS enough room in your system and distribution libraries to accommodate 
JIS3 moaules. Figure 1 shows the estimated additional space ana 
airectory blocks required in eacn library to be updated. (The space and 
directory blocks given ate in addition to the VS2, Release J amounts.) 

It also shows the ,hysicai record size (2DKSIZE) and record format 
(RICFM) for each library updated. The installation proceaute assumes 
that all aata sets are online. 


|..aditional lAdaitional | Physical I 
(Space Used ICirectory | Record i 
1 (in tracks) ] I Size 1 

Library Name |2314|3330|3340(i:locKs Usedl2314| 3330|3340|Format 


J’iSI.AGINLIb 

-+- 

1 

5 

1 

—4- 

4 1 

5 

-4- 
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|1bb0| 1680|16tt0| 

FB 

SYS1.A0S5A 

T 

1 

15 

“ + 

I 

9 1 

14 

1 

75 

16 1 441 6 1 44 1 6 1441 

0 
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T 

1 

1 

—j.— 

1 

1 1 

1 

1 

1 

i 7280i12960183201 

II 1 1 

F3 

S1S1.J2SJLIB 

T 

1 

15 

“T“ 

1 

9 1 

14 

1 

75 
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U 

SYSI.PAPRLIi' 

T 

1 

1 

“T 

1 

T” 
1 1 

1 

1 

1 

[ 80i 60i 80i 

F 

SY31.PROCLIB 

T 

1 

1 

"T 

1 

1 1 

1 

1 

1 

|728ol 12960*83201 

FB 

3Y3 1 .LPA-IB 

— T 

1 

10 

•T 

1 

T” 

6 I 

9 

1 

30 

17294* 13030l836t>l 

U 


IijUre 1. J"33 estimated Space /equiieuients in System anu 

Li^triDution Libraries 
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SKP HZfiUIliZgEIiTS 


3MP CATALOGED PROCEDUilS 


before you can use SMP to install JES3, you must supply a procedure or 
aodify your own procedures to indicate to the SMP program where the 
required SMP data sets are located, where the system ana distribution 
libraries to be updated are located, and where the scratch data sets are 
located. The name of this procedure is required in the RECEIVE 
parameters of the installation macro instruction. This proceaure should 
be cataloged in SIS 1.PEOCLIB. Separate procedures may be used for the 
RECEIVE, APPLY, and ACCEPT SMP functions. 

An example of the JCL and job stream to update SYS1.PEOCLIB is as 
follows: 


//JES3SHP 

JOB 

• • • 

// 

EXEC 

PGM=IEBUPDTE,PARM=NEH 

//SYSPRIST 

DD 

SY3CUT=A 

//SYSUT2 

DE 

DSH=SYS 1.PROCLIB,DISP = SHa,VOL = SSR = SG2001,UNIT=3330 

//SYSIN 

DD 

DATA 

./ 

ADD 

LIST=ALL,tIAM2=SMPRSC 

//SMPREC 

PROC 


//SMPSTEP 

EXEC 

?GM=HMASM?,PARM='DATE=U' 

//SHPPTS 

DD 

DSN=MVSMPPTS,DISP=CLB 

//SMPOUT 

DD 

SYSOUT=A 

//SMPLOG 

DD 

DSN=MVSMPLOG,DISP=MOD 

//SKPCDS 

ED 

DSN=MVSMPCDS,DISP=OLD 

//NUCLEUS 

DD 

DSN = SyS 1.NUCLEU3,DISE=0LD 

//SVCLIB 

DD 

DSN=SYS1.SVCLIB,DISP=OLD 

//LINKLIB 

DD 

DSiN=SY31 .LINKLIB, DISP=OLD 

//SMPMAC1 

DD 

DSN=SYS1.AOSBA,DISP=0LD,UNIT=2314,VOL=S£R=DLIB02 

//SMPMAC2 

ED 

DSN=SYS1.AGENLIB,DISP=OLD,UNIT=2314,VOL=S£R=DLIB02 

//SMPMAC3 

DD 

DSN=SYS1.APROCLIE,DISP=OLD,UNIT=2314,VOL=SSH=DLIB01 

//SYSLIB 

DD 

DSN=SYS1.AOSBA,DISP=OLD,UNIT=2314,VOL=SEH=DLIB02 

./ 

ADD 

NAME=SMPACC 

//SMPACC 

PROC 


//ACCEPT 

EXEC 

PGM=HMASMP 

//SMPOUT 

DD 

3YS0UT-A 

//SYSPRINT 

EE 

SYSOUr=A 

//SMPLOG 

ED 

DSN = MVSMPLOG,DISP= (MOD,KEEP) ,UNIT = 23 14,YOL=SER = SMPDSK 

//SMPCDS 

DD 

DSN=MVSMPCDS,DISP=(OLD,KEEP) ,UNIT=23 14,VOL=SEH=SMPDSK 

//SMPPTS 

DD 

BSN-=MVSMPPTS,DISP= (OLD,KEEP) , UNIT = 23 14 , VOL=SER = SMPDSK 

//SMPACDS 

DD 

DSN=MSMPACDS,DISP= (OLD,KEEP) ,UNIT = 2314,VOL=S2R = SMPDSK 

//SYSUTI 

DD 

DISP=(NEW,DELETE),UNIT=SYSDA,SPACE= (CYL, (2,1)) 

//SYSUT2 

DD 

DISP= (NEW,DELETE) ,UNIT = SYSDA,S?ACE= (CYL , (2,1)) 

//SYSUT3 

ED 

DISP=(NEW,DELETE),UNIT=SySDA,SPACE=(CYL,(2,1)) 

//SMPMACI 

DD 

DSN=SYS1.AOSBA,DISP=OLD,UNIT=2314,VCL=SER=DLIB02 

//SMPKAC2 

DD 

DSN=SYS1.AGENLIB,DISP=OLD,UNIT=2314 ,TOL=SEa = DLIB02 

//SMPMACa 

DD 

DSN=SY3 1.APRCCLia,DISP=OLD,UNIT=2314,VOL=S£B=DLIB01 

//SMPCKTL 

DE 

DDNAME=SYSIN 

//AOSbA 

EL 

DSN^^SYS 1. AOSBA, UNIT=2314, VOL=SER=DLIB02 ,DISP= (OLD, KEEP) 

//AGEHLIB 

DD 

DSN=SIS1.AGENLIB,UNIT=23l4,VOL=SSfi=DLIB02, 

// DI3P= (OLD,KEEP) 


//APR0CLI3 

DD 

DSN=SYS1.APROCLIB,UNIT=2314,VOL=SEP=DLIB01, 

// DISP=(OLD,KEEP) 


./ 

ENDUP 



PROC SMPREC ASSUMES SMP DATA SETS ARE CATALOGED. 
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P90C 3KPACC REFEkINCES SMP DATA Si,TS VIA VOL AND UNIT. 

Tr.e SMP data sets and system libraries are located on a 3J30 
direct-access device with a volume serial number of SG2001. The 
distribution libraries are located on 3330 direct-access devices with a 
volume serial number of LLID01 and DLIE02. All of tliese data sets mast 
be online when installir.j JES3. 
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S;1P DATA SZT3 


Allocate auli SKPACDS, SJiPCDo, ShPPTS, and SKp^OG data oets ensuring 
different names than those on your active 5H?. Allow at least 15 
cylinders for the ShPr-lz data set in oruer to PZCaIVi: the JFGJ system, 
bake sure that only the new ahp uata sets ate used to install JZS3. The 
JZS3 SnrACDS can be copied to the system S^PCDS after the stage II 
system generation of JE33 has been applied to the current Sht oata 
sets. This IS to update the SGPChl to reilect the apt-lication of the 
JI33 IC?.. 

Wi;en running the ShP gob stream to install J353, you must have the 
ShPACDS, 3KPCDS, 3h?LCG, and SfiPPIS data sets online. In addition, both 
a N’UL:. CDS and a iJULi. PTS is required. The estimated additional space 
used by the SdP data sets are as follows; 


(- 1 

I I Additional Space I I I 

I I Used (in tracKs) |Physical| I 

I 3BP Datal -IBecord | 3ecord l 

1 Set |2305-1i2305-2|2314|3330|3340|Size IFormatl 

I-p-p--4.—,—I-^-1 

I StiPACDS I 3| 2|2|1|2t80 | F| 

I SMPCDS I 9| 5|6|4|8|80 | F| 

I 3MPLOG I 21 I 14 I 26 I 13 I 23 I 260 | U | 

I Si'iPPTS I 9 I 5 I 6 I 4 I 8 I 80 | FB | 

» _ _ -- - ■■ ■ ___-i 


An example of the job stream needed to update the Pz.i'lAX field is as follows 


//0SSSJCB1 

GOD 

« • • 


Z/STZP 

ZaEC 

PGh^HMAShP 


//SYSPRIWT 

DI' 

SiSCUT=A 


//SMPOUT 

DD 

SyS0UT=A 


//SMPLOG 

rt ^ 
ij 

DISP=M0D,DSN=SI1PL0G 


//SMPCDS 

DD 

DI3P=Oa,L ,DSN=SHPLCtS 


//SYSUT1 

DC 

DI3P=NrW,SPAC3= (CYL, 

(1,1)) ,UNIT=SYSDA 

//SMPCNTL 

LD 

UCLIH. 

« 


/* 

PEP SI 
i^SDUCL 

S SaZL(Z030) NUCIL(O) 

PSMAX (dOO). 

The minimum 

value- 

allowed for the PSMAX 

field in the SMPCDS data 


INSTALLATION HACftO INSTfiUCTION 


The installation macro instruction is in the first file of the 
distribution tape and is used to create the job stream to install JZS3. 
The format of the installation macro instruction is: 

Operation Ot-eraud 

C?9926 t jtCCF?T-pr ocname ] 

[ ,AE:-'i.T=procname ] 

r ,C0.1PACC= (ddudme[ ,...])] 

[ ,C0.jPAPP= (adndae[ ,...])] 

[ ,CRrAPZ = i 3^:1^019/6250}] 

[ .cai'NIT^r unit I 2400 11 

,?ROCES5= (SL'CZIVSC ,.APPL¥]( ,ACCEPT ][ , SCRATCH ]| ALL) 

[,F0HCE=lN0|iZ3 }] 
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[,PRNTCLS-A] 

[,PNCHCL£=Bj 
[ , BEvJZIVE-i rocname ] 

,a2L^JZSKE; 

, KKIL'NITsunit, ii'KIVOL=volume 
[,aK2UNIT=unit,WK2V0L=voluBe ] 

uote: Underscore indicates default. 

wnere: 


CK9920 

is the name of the installation nacro instruction. 
rtCCEPT=i.rocnane 

specifies the procedure name for the SMP aCCZPT function. This 
parameter must be sjecified if PROCSSS=ACCZPT or A..L. For 
information on the required cataloged procedure, see "SMP Cataloj'ed 
Procedure." 


AP?LY = procnamr= 

specifies the procedure name for the SdP APPi.! function. rhis 
parameter mast be specified if PROC5SS=APPLY or ALL. For information 
on tiie required cataloged procedure, see "StiP Catalojed Procedure." 

C0MFACC= (ddr.ame[ ,...]) 

allows you to specify whicn distribution libraries you would like 
compressed before they are modifiea. The distrioution libraries that 
cannot be specifiea m this parameter are SYS1.AG£SLIB, SYS1.AKSLP, 
SY31.AHACLTE, and SYS1.ASAMPLIb. The ddnaae is the ddname required 
by £:iP which is the lowest level index name in tiie target library. 

For example, use AOSEA for SYS1.AOSBA. 

C0HPAPP= (ddnaae[ ,...]) 

allows you to specify which system libraries you would like 
compressed before they are modified. The system libraries that 
cannot re specifieu in this parameter are SYSI.HSLF, SYS1.MACLIb, and 
5YS1 .SAhPLIB. YOU should not compress SYS 1. LINKLIi. if you are 
aodifyinj the current system. The ddname is the ddname required oy 
SMP which IS the lowest level index name in the target library. For 
example, use NUCLEUS for 5YS1. iJUCLEOS. 

C 1TAi:'S = { 9^J6001 9/025C j is an optional parameter that specifies the 
number of tracks and the density of the distriouticn tape. 

Cf.U.Jir={ur;it|2a00} 

IS an optional parameter that specifies the type of tape unit on 
which the distribution tape is to be mounted. If cauMT is not 
coded, 2400 is the cefauit. 


?P0C3S£= (r.2CZIVS[ , APPLY ][ , ACCEPT ]p , vC3 ATCK ] I A LL) 

This parameter defines the functions to be performed in the created 
ShP job stream. 


SZCSIVE - checks prerequisites anC does all necessary updates for 
later S;JP functions. This must be the first function 
performed beroie any other SMP function is executeu. If 
this sutparameter is specified, then EEC£IVS=procndffle must 
also be specified. 


APPLY' 


specifies putting modifications 
of the most recent level of the 
subparameter is specified, then 
specified. 


into the system libraries 
system. If this 
APPLi=procname must also be 
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ACC3PT - specifies puttinvj Dodifications into the distribution 
libraries. If this subparaoeter is specified, then 
ACC3PT=piocnaae aiast also be specified. 

SCKATCH - specifies that the data sets (on the direct-access device 
work voluae) copied froa file 2 of the distribution tape 
may be deleted after processing. 

ALL - specifies all of the above. If this subparaaeter is 

specified, then KECSIVS=procnaae, APPLY=procname, and 
ACC3PT=procnaae aust also be specified. 

FORCE={!iO|IES] 

NO - specifies that if prerequisites are not net such as the 

correct release nuaber, the aodification is not aade to the 
systea or distribution library. 

YES - specifies that if prerequisites are not net, the aodification 
is still aade to the distribution library. 

PRMTCLS=A 

specifies the class associated with the output device to which you 
want your output data set written. 

P3CHCLS=B 

specifies the class associated with the output device to which you 
want your output data set punched. 

HiCZIVE=procnaBe 

specifies the procedure name for the SMP HECSIVE function. This 
parameter aust be specified if PBOCESS=RECEIVE or ALL is specified. 
For information on the required cataloged procedure, see "SUP 
Cataloged Procedure." 


RSL=JESHS 

specifies the independent component being added to your systea. 
HK1UNIT*unit,BK1V0L=voluBe 

are required parameters that identify a direct-access device and 
volume to be used for work space. The unit aay be a device naae, the 
actual device address, or a generic naae; voluae is the volume serial 
number. Ten cylinders are allocated on this voluae. 

ilK20NIT=unit,HK/!V0L=voluae 

are optional parameters that identify a second direct-access device 
and volume to be used for work space. The unit aay be a device naae, 
the actual device address, or a generic name. If these parameters 
are not specified, values for liK2UNIT and HK270L will be the same as 
for NKIONir and HK1V0L. You aay expect better performance when work 
space is divided between voluaes. 


CODING THE INSTALLATION MACRO INSTRUCTION 


Figure 2 shows the job control language and installation macro 
instruction. This is required to create the SHP job stream to install 
JES3. 

The COPYHACS step in USERJ0B1 causes file 1 froa the distribution tape 
(which contains the installation aacro instructions) to be copied to 
SYS0T2. 

The ASHPARMS ste^ in US33JOB1 causes the definition of the installation 
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aiacro instruction to be expanded by the assembler. The figure shows the 
JCL required to punch the SMP job sttean on cards; the output could 
also, however, be directed to tape or direct-access voluae. 

//ICHLOAD JOB ,A,hSJLEVBL=(1,1),SEGICN=512K 
//COpyMACS EXEC PGa=IEEUPDT3,FAJn=»EW 
//SYSPRIWT BE DUMMY 

//SYSUT2 DD UNrT = SYBDA,DSN = 66CRl;i,DISP=(S2K,Pi5S) , 

// SPACE= (CYD, (2, 1,5) ) ,DCD={I,"EC^ = bC,RECfM = FB,i3LKSIZ3=16aO) 

//SYSIS L'V USII-58C,DISt'= (ODD, KEEP) , VCLUM3 = SEE = CHTAPE , LAB5L= (1,aL) , 

// DC3= (L5 •:Ch = faO, EECfK=FE, B-hSIZ 2 = 600, DEIi = 2) 

//AShPARhS EXEC ASMf C , PARi'l. ASM= • DECK , NOLCAD , LINECNT = 5 2 ' 

//ASK.SYShIB CD L ISP= (ODD ,DE*.ETE) , DSN = f;&Cai R 
//ASM.SYSPUSCii DD UNIT-580, DISP= (NEW, KEEP) , VOL=SER = ICTAPE , 

// LABEL={,tJL) ,DCB= (LaECL=60,RSCrK = F,BLKSIZE = d0,DES = J) 

//ASM.SYSIN CD DATA 
EEFEC 

//LOADICH JOE ,<i,REGIOU=512K,MSGLEV2L= (1, 1) 

CR992b CBTAPE=9/600,CKUNIT=560,PHOCESS=(RECEIVE,ACCEPT,SCRATCH) , ♦ 

RECEIVE=SMPREC,ACCEPT=SMPACC,PRNTCLS=A, ♦ 

FORCE=YES, ♦ 

P:ICHCLS = B, HK 1UNIT=2314, HK1VOL=ASPUT6, WK2UNIT=2314, * 

3K2VOC=ASPUTb,5EL=JESKE 

END 

/* 

Figure 2. Sample JCL and Installation Macro Instruction 


The ASE.3YSIN DD statement identifies the remainder of the statements as 
input. The REPRO instruction causes the statement that follows, 
USERJOBE, to re reproduced in the created SilP job stream. 

USEEJ032 executes the 3MP job stream created in the ASMPARKS step in 
USERJ0B1. All the data sets to be ui’dated and the required ShP data 
sets should be online during this job. The job stream causes; 

• File 2 to be copied from the distribution tape to a work volume. 

• The RECEIVE function of SM? to be executed. This function checks 
prerequisites and aoes all necessary updates for later SMP 
functions. This occurs because PHOCESS=RECSIVE is specified in the 
CR9926 macro. 

• The FORCE function of SMP to be executed. This forces the 
appropriate modification to be made to the distribution libraries. 

• The data sets on the work voluae containing file 2 from the 
distribution tape to be deleted. This occurs because PROCESS=SCRATCH 
is specified in the CR992o macro. 

• The COMPAPP and COht'ACC function of 3BP to be executed. This 
compresses the indicated libraries. 

• The generated job stream must be edited before it is run to install 
the JES3 ICR. The workaod data set must have the SPACE parameter 
filled in. 

The following sample job stream was generated by the CH9926 macro. JCL 
was added to scratch and allocate new null SMP data sets, and to update 
the null CDS to accept the ICR. The //EXEC SMPR3C and //EXEC SMPACC 
cards also created by the CR9926 macro have been removed and the 
procedure JCL inserted for purposes of illustration. The added JCL 
statements ate enclosed in boxes. Not all SMP control statements 
generated ate illustrated. If the installer wishes to use the 
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frocedures created by executing tne exami^le on page 9, the //22SC cards 
should not be removed and the procedure JCL should not be placed 
inline. 

//LOADICB JOb , A,R£GIO!J = 512K.aSGL3VEL= (1, 1) _ 

// 2X2C PGB=IEHPfl0GM 

//SySPHIKT DC SySOUT=A 

//ONE DD ONIT=2314,VOL=Sna=SKPDSK,DI3P=OLD 

//TWO DD UNIT=2314,VOL=SZR=DLIB02,DISP=OLD 

//SYSIN DD • 

//* THE FOLLOWING JCL WAS ADDED TO SCRATCH OLD DAT» SETS AND 
//* ALLOCATE NEW NULL SMP DATA SETS AND DLIE (AOSBA) 

SCRATCH DSNAME=MV3f1PCDS,70L = 2314=SMPDSK, PURGE 
SCRATCH DSNANZ=i'iSMPACDS,VOL= 23 14 = £HPDSK, PURGE 
SCRATCH DSNAME=MVSMf?TS,VOL=23l4=SHPDSK,PURGE 
SCRATCH DSN A;iE=tiVSBPLOG,VOL=2314=3KPDSK, PURGE 
SCRATCH DSNAMB=SySI.AOSBA,VOL=2314=DLI302,PURGE 

/* 

// EXEC PG{1=I£FBR14 

//A DD DSN=SyS1.AOSBA,UNIT=2314,VOL=SER=DLIB02,DISP=(SEW,KEEP) 

// SPACE=(CyL,(20,5,500)) 

//E ED DSN=MVSflPPTS,0NIT=2314,V0L=SER=SHPDSK,DISP=(NEW,KEEP), 

// SPACE=(CYL, (20,5, 1000)) 

//C DD DSN = HVSMPCDS,ONIT=2314,VOL=SER=SMPDSK,DISP=(NEK,KEEP) , 

// SPACS=(CYL,(20,5,1000)) 

//CC ED DSN=KS!lPACDS,UNIT=2314,VOL=SER=SHPDSK,DISP=(NSW,KEEP), 

// SPACE=(CYL, (20,5, 1000) ) 

//D ED DSN=KVSRPLOG,ONIT=2314,VOL=SER=SHPDSK,DISP=(NEW,KEEP), 

// SPACE=(CYL,(20,5)) 

Z!______ - 

//* FOLLOWING JCL IS GENERATED BY INSTALL MACRO. 

//MOVE EXEC PGi5 = I2BCOPY 

//* 

//*♦♦** :.OAD THE PACKAGING DATASET (S) TO A DASD WORK VOLUME 
//* 

//SYSUDUHP DD SYSOUT=A 

//SYSPRINT DC SySCUT=A 

//SYSUT3 DD UNir=2314,VOL=SES=ASPOTb, 

// SPACE= (TRK, (5,2)) 

//3YSUT4 EC UNIT=2314,VOL=SDR=ASPUr6, 

// SPACE=(TRK,(3,2)) 

//PAK1 DD UNIf-2314,VOL=SZR=ASPUT6,D:SP=(,KEEP),DSN=PAK1, 

// SPACE=(ClL^i30^J^300)) 

//* THE SPACE ALLOCAlION FOR PAK1 MUST BE MADE IT IS NOT 
//* GENERATEL BY THE INSTALL MACRO. 

//TPI DD UNIi' = 580, VOL = SEa=CRTAPE,DISP= (OLD,PASS) , LABEL= (2 , NL) , 

// DCB=D3N=2 
//SYSIN CD * 
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//SMPOOT 

DC 

SYSOOT=A 

//SMPLOG 

DD 

DSK=MVSMPLOG,BISP=MOB 

//SMPCDS 

DD 

DSN=MVSKPCDS,DISP=OLE 

//SMPPTS 

DD 

DSN=MVSHPPTS,DI3P=OLD 

//SHPCNTL 

DD 

DDNAME=SYSIN 

//SYSUTI 

DD 

DISP= {,DELETE) ,UNIT=SYSDA,SPACE=(CYL, (10,10) ) 

//SYSIN 

DD 

* 


UCLIM . 

REP Si'S PEKAX(500) . 


ENDUCL . 

/* 

//♦ FOLLOWING INLINE JCL ADDED TO RECEIVE THE ICR. 
//* IT IS USED IN PLACE OF //EXEC SMPEEC PBOC. 


//SMPSTEP 

EXEC 

PGM=HMASB?,PASH='DATS=0' 

//SMPPTS 

DD 

DSN=MVSMPPTS,DISP=CLD 

//SMPOUT 

DD 

SYSOUT=A 

//SMPLOG 

DD 

DSN=MVSMPLOG,DISP=BOD 

//SMPCDS 

DD 

DSN=MVSMPCDS,DI3P=OLD 

//NUCLEUS 

DD 

DSN=SYS1.NUCLEUS,DISP=OLD 

//SVCLIB 

LD 

DSN=SYS1.SVCLIB,BISP=OLD 

//LINKLIB 

DD 

DSN=SYS1.LINKLIB,DISF=OLD 

//SMPMAC1 

DD 

DSN=SYS1.AOSBA,DISP=CLD,ONIT=2314,VOL=SER=DLIB02 

//SMPMAC2 

CD 

DSN=SYS1.AGENLIB,DISP=OLD,UNIT=2314,VOL=S£R=BLIB02 

//SMPMAC3 

DD 

DSN=SYS1.APRCCLIB,DISP=OLD,USIT=2314,VOL=SER=DLIB01 

//SYSLIB 

ED 

DSN=SYS1.AOSBA,DISP^OLD,UNIT=2314,VOL=SER=DLIE02 

// 

ED 

DSN=SYS1.AGENLIt!,DISP=OLD,ONIT=2314, VOL=SER = DLIB02 

// 

ED 

DSN=SYS1.APEOCLIB,DISP=OLD,UNIT=2314,VOL=SER=DLIB01 

//SMPCNTL 

DD 

DDNAME=SYSIN 

//SYSUT1 

ED 

UNIT=SYSDA,SPACE= (1700, (600,100)) 

//sysuT2 

DD 

ONIT=SySDA,SPACB=(1700, (600, 100)) 

//SYSUT3 

DD 

0NIT=SYSDA,SPACE= (1700, (600,100)) 

//SYSPRINT 

DD 

SYSOUT=A 


//* FOLLOWING JCL AND SHP CONTROL STATEMENTS GENERATED EY THE 
//* INSTALL MACRO. 

//PAK1 ED UNIx = 2314, VOL=SSR=ASPL'T6,DISP=SHR,BSN=PAK1 

//SiSIN DE * 

RECEIVE SELECT (UZ99926) . 

/* 

//S.iPPTFIN ED * 

♦+ PTF (UZ99926) . 

♦+ VER (2030) 

/*JSS3 PTF VS 2-3*/. 

+♦ MOD (lATABMN) DISTLIB (AOSBA) EKLIB (PAK1). 

++ MOD (TATABNA) DISTLIB (AOSBA) LKLIB (PAK1). 

** MOB (IATW3N) DISTLIB (AOSEA) LKLIB (PAK1) . 


+ + 

+ ♦ 
+ ♦ 
+ + 
+ ♦ 
+ + 
+ + 

+ ♦ 


MOD (lATSTN) DISTlIb (AOSEA) LKLIB (PAK1) 

TALIAS(IATKI11). 

MOD (lAIKXN) DISTLIB (AOSEA) LKLIB (PAK1). 

MOD (lATWYN) DISTLIB (AOSBA) LKLIB (PAK1) . 

MAC (SGIAT6PA) DISTLIB (AGENi.IB) TXLI3 (PAK1) . 

MAC (S3IATOPR) DIST:.IE (AGESLIB) TALIB (PAKI). 

MAC (SGIAT5JL) DISTLIB (AGENlIc) TXLIB (PAM). 

MAC (5GIAT4JL) DISTLIB (AGSNLIE) TaLIB (PAKI). 

MAC (SGIAT5SI) DISTLIB (AGENLIB) TXLIB (PAKI). 

MAC (JE3C) DISTLIB (APEOCLIE) TXLIB (PAKI). 


//* FOLLOWING INLINE JCL ADDED TO ACCEPT THE J£S3 ICR AND FORCE IT 
//* TO THE APPROPRIATE DLIB3. II IS USED IN PLACE OF //EXEC SMPACC PROC. 


//ACCEPT 

EXEC 

PGL^HMASMP 

//SMPOUT 

DD 

3YSOUT=A 

//SYSPRINT 

DD 

SYSCUT=A 

//SMPLOG 

DD 

DSN = MVSMPLOG,DISP=(MOD,KEEP) ,UNIT = 23 14 ,VOL=3ER = SHPDSK 

//SMPCDS 

CD 

DSN=MVSMPCBS,CISP=(CLD,KSEP) ,UNIT = 23 14 ,VOL=3EP = SMPBSK 
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//SMPPTS DO DSN=MVSMPPTS,DISP=(OLD,KEEP),USIT=2314,VOL=SEE=SMPDSK 

//SnPACDS DD DSN = i'1Sa?ACDS,DISP= (OLD, KEEP) , U:JIT=23 14 , VOL=SEP=SMPDSK 

//SYSUT1 ED DISP=(NEW,DELETE) ,UNIT=SYSDA,SPACE= (CYL, (2,1)) 

//SYSUT2 DD DISP=(NEW,DELETE),ONIT=SYSDA,SPACE= (CYL, (2,1)) 

//SYS0T3 DD DISP= (NEW,DELETE) ,UNIT=SYSDA,SPACE= (CYL, (2, 1)) 

//SMPMAC1 DD DSN=SYS1.AOSflA,DISP=OLD,UNIT=2314,TOL^SER=DLIB02 

//SMPMAC2 DD D5N=SYS1.AGENLIB,DISP=OLD,UNIT=2314,V0L=SER=DLIB02 

//SMPMAC3 DD DSN=SYS1.APROCLIB,DISP=OLD,UNIT=2314,VOL=SE8=DLIB01 

//SSPCNTL DD DDNAM£=SYSia 

//AOSBA DD DSN=SYS1.AOSEA,UNIT=2314,VOL=SER=DLIB02,DISP=(OLD,KEEP) 

//AGENLIB DD DSH = SYS 1.AGENLIB,UNIT=2314,VOL=SES = DLIB02, 

// DISP= (OLD,KEEP) 

//APROCLIB DD DSN=^SYS 1. APROCLIB, UNIT = 23 1 4 , VOL = SER = DLIoO 1, 

// DISP= (OLD,KEEP) ___ 

/7» FOLLOWING JCL AND SMP CONTROL STATEMENTS GENERATED BY THE 
//♦ ICR INSTALL MACRO. 

//PAK1 DD ONIT = 2314,VOL=SER=>ASPUTb,DISP=SHR,DSN = PAK1 

//SYSIN DD * 

ACCEPT SE..ECT (UZ9992b) FORCE . 

//* THE FORCE KEYWORD IS NOT INSERTED 3Y THE INSTALL MACHO. 

//* IT MOST BE ENTERED BEFORE THE ICR IS INSTALLED. 

/* 

//CLEANUP EXEC PGM=IEFflR14,COND=EVEN 
//* 

//**♦♦* DELETE THE PACKAGING DATASET(S) 

//* 

//SYSUDUMP DD SYSC0T=A 

//CLEAN1 DD DSN=PAK1, 

// DISP= (OLD,DELETE) ,0NIT=2314,V0L=SEB=ASPUT6 
/* 

For any SMP errors, see OS/VS Syst ea Mod if ication Progtam (SHP). For 
any system errors, see OS /V S Message L ib rary: VS2 System Messaiijs and 
OS/VS Message Library: Routing and Descriptor Codes. 


SYSTEM GENERATION 

This section describes the procedure for performing a JES3 generation 
and a remote terminal processor program (BMT) generation in an OS/VS2 
Release 3 system. 

The process of generating JES3 is referred to as JES3 generation. The 
process of generating the remote terminal processor programs to operate 
in a JES3 system is referred to as RMT generation. Before you do a JES3 
or RMT generation, you should be familiar with the Release 3 edition of 
the OS/VS2 System Gener ati on M anu al, GC26-3792. 


PTF REQUIREMENTS 


OS/VS2 Release 3 PTF number UZ00809 contains JES3 system generation 
support. It must be applied as a prerequisite to a JES3 generation. 


DISTRIBUTION LIBRARY 


Distribution data set SY31.AOSBA (created during installation of ICR via 
SMP) must be cataloged in the qenerating system. 
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SISTEM GENESATIOJJ MACBO IHSTRUCTIOSS 


A new macro instruction, JEo, has been defined and must be used for JES3 
generation. In addition, a few new parameters and options have been 
added to existing system generation macro instructions. The JE3 macro 
instruction will be described in detail, whereas only the applicable 
parameters and options of the existing macro instructions will be 
described. 
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fl§££2 Instruction 


The JES macro instruction is used to specify the configuration for 
JiS3. The J23 macro supplies information to .jenetate a nasic 0253 
initialization deck vnich is added as the JES3lNxx aeoiber ot 
SiSI.PARHLIB, where xx is equal to the PARfllD parameter. In addition 
tne JES macro causes JCL to be created which, durinq stage II will be 
used to copy the JZS3 member from SYS 1.APR0CLI5 to SYS1.RROCLI5 and copy 
and/or linkedit the appropriate otgect nodules into SYSI.nPALIE ana 
SYSI.JESlLId. 

The following Keyword parameters ate used for the JES macro instruction: 

r L0CLJES={li0| YES}] 

[?ROCID={JS53Iprocedute-naae } ] 

[ PARMID={00 Ip armlib-member-default J] 

[ RDP=({ OOCIrdi-device-address ] 

[ PRT=(({00£Ip rt-device-address ),{J403(prt-device-type j, 

I ElTprint-ttain}),(...)) ] 

[ PUS=({ OOPIpunch-device-addressJ,...) ] 

[ CSS=(({OJFIcon3ole-device=addres3 ),(32^51console-ty* e )) , (...)) ] 

03330=(device-address,..., (device-address,n) ,...) 

[ 02314=(device = address,...,(aevice-address,n) ,. ..) ] 

[ 13400= (device-address,..., (device-address,n) ,...) ] 

[ T2400=(device-address,.,., (device-address,n),...) ] 

Note: Underscore indicates default. 

Tne keyword definitions follow: 

LOCLJES - defines whether ot not the system being generated will be used 
only as a JES3 local processor. 

If LOCLJES=NO IS specified, a JES3 initialization deck is added to 
SYS1.PARMLIB (see the PARKED keyword below for meaner names), the 
JES3 object program is copied from the JZS3 distrinution library to 
the SYS 1.JE33..IE data set (this data set must be cataloged), and the 
JES3 procedure is copied from the JIS3 distribution library to 
3YS1.PR0CLI3 (see the PROCID keyword below for the member name). 

If LOCLJ35=YES is specified, only the J3S3 procedure is copied from 
tr.e JE£3 distribution library. however SY31.J353LID must oe 
cataloged prior to executing J3S3. 

PROCID - aefines the name of the JES3 procedure in S YS1. P.^OCLia. This 
name mast correspond with the name defined as PRIjUB on the SCBEDULR 
system generation macro instruction. 

PaRHIO - defines the suffix to the SYSI.PARHLIB member name into which 
the JES3 initialization deck will be added. PARhID can be 
alphanumeric but must consist of 2 characters. 

RDS,PRT,PUN ,CN£ - defines the unit recoid devices for JE33. J3S3 device 
names ite assigned to each device, foi example, REa= (00C,01C) would 
cause the naae RDOOC to re assigned to OOC, and RD01C to OIC. 

Note: rDR and PUN must be ,;540 type devices. 

D3330,12314,I34G0,T24o0 - defines the direct access storage devices and 
tape devices to be managed by JES3. A string of device addresses can 
be defined by (address,n) where n is the number of sequential 
addresses to be assigned, loi fxaaile f3330= ( (1 30,b) , ( 230,6)) defines 
3330 DA3t cevices it addresses 130-137 and 230-237. The E3JJ0 
keyword is required for Jr:.:3. 
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CONSOLE Macro Instruction 


Each JES3 console should ne generated as a device on each processor 
(where physically possitle) for dynaaic system interchange ^OSI). In 
addition, each JES3 console with input capaoility should be generated as 
a multiple console su,.tort (MCS) secondary console on each processor. 
Khere this is not possible, dummy secondary consoles should be uefineo. 
PCS secondary consoles ate siecified in the CONSOLE macro during system 
jeneration. Eummy secondary consoles ate generated by specifying 
ryp5=JES on t!ic CONSOLE macro. Nhen a dummy console is defined using 
TYPI^JES the only other CONSOLE parameter which is accepted for that 
dummy console is VALLCMI;=. 

Generating a device creates a amt control block (UCB) . Generating a 
secondary console creates a unit centicl module (UCL) entry. JECi 
requires a UCE- for each console on the global processor in otoei to 
physically issue I/O. If a JESi console operator wishes to communicate 
with MVS on a given piocessoi, then a OCM entry must exist on that 
processor for ti^at console. for example, a UCM entry must exist on tiie 
processor naraea sy2 for console 040, if the operator at that JES3 
console wanted to issue the following command; *1 SY2 D A. The command 
would then be processed and the response sent back (across the 
channel-to-channel (CTC) aaapter, if necessary) to the console at 040. 

The UNIT parameter of the CONSOLE initialization card specifies an 
address on each processor for eacn console. If there is a UCh on the 
processor for that address, then the console can communicate with that 
processor. It makes no difference what the iiCM loons like; it may Lave 
been created for graphic console, hut is neing used by a JSS3 2740. The 
UCM IS only used for rcutinj of messages. 

If It is not physically possible to generate real secondary consoles on 
a given processor due to configuration restraints, then dummy UCK 
entries shoula be generated. Enough UCM entries should be generated on 
each processor to handle the maximum number of JES3 consoles on any 
given system. If JES3 consoles aie added to the configuration after the 
JES3 generation bas been completed, they may be used as JZS consoles 
without doing a new j:.S3 generation b) simply adding a console card to 
the JE23 initialization deck. Tnese consoles will not, however, be aole 
to communicate with MVS, unless extra dummy UCM entries had previously 
been generated. 

Two JE33 consoles, one with a real UCM anc the other with a dummy UCM, 
will have identical capabilit i^-S comaunicat^-ug with JE5 and MVS. The 
difference is that the former may be used as a KCS console, at times, 
while the latter may not. 

On the global (.rocessor, a console an<i its corresponding UCK may not be 
used by MCS and JES3 simultaneously. The console must ne offline to KCS 
before JE33 is initialized for JEi3 to allocate the device. The only 
exception is for terminals similar to the 1052 (such as the 1052, 3210, 
and 3215), which may be sharea. In this case, however, care must be 
taken to insure tnat MCS and JESi do not both issue the same message to 
the same console. 

On a local processor, the UCK may be shared with an active MCS console 
on tnat processor and a JE33 console on the global processor without any 
problem. Any write-to-operator (WTO) message issued on tne local for 
the UCM in question will he sent i.oti. to the active MCS console on the 
local and the JEEi console on the glonal. 
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Sole or all of the systea data set 9 can be defined either during systea 
generation, by using the CATASET aicro, or before systea generation, by 
using JCL and/or the access aethod services. This section contains 
inforaation about the JES3LIB systea data set and about defining it 
using the DATASET aacro. 

The DATASET aacros that you code with a SPACE paraaeter are used daring 
systea generation to allocate and iefine the systea data sets. Oaring 
Stage I, the aacros are asseabled and expanded into the job control 
language and coaaands teguired to execute the access aethod services. 
During Stage II, the expansion is used to allocate the specified space 
on systea voluaes and catalog the systea data sets in the aaster 
catalog. The first systea data set that is created (if specified in a 
DATASET aacro) is the aaster catalog. Then, space is allocated to the 
reaaining systea data sets and they are cataloged. Also, if you 
specified an index in the GENEBATE aacro other than SXS1, ail of the 
systea data sets are renaaed during Stage II froa the index you 
specified to SISI. 

The folloHing is an exaaple on hov to define the JES3LIB systea data set 
using the DATASET aacro. 

JES3LIB DATASET JES3LIE,TOL=(SG2001,2314),SPACE=(CXL,(15,2,75)) 

The following describes the SXS1.JES3LIB data set. 

SXS1.JES3LIE is a partitioned data set that contains all JES3 nodules 
except the subsysten interface nodules that reside in SXS1.LPALIB. It 
is required if running JESS. 

This system data set aust be on a direct-access voluae, which can be the 
systea residence voluae, and aust be cataloged. Secondary space can be 
allocated. If this systea data set is used, a DATASET aacro aust be 
specified for it, even if it has been pre-defined. If it has been 
pre-defined, oait the SPACE paraaeter in the DATASET aacro. By oaitting 
the SPACE paraaeter, space will not be allocated. 

It is recoaaended that the following DCB subparaaeters be specified: 

BECF1J=0,BLKSIZS=14136 for 2305 nodel 1, 

14660 for 2305 aodel 2, 

7294 for 2314/2319, 

13030 for 3330/3333, or 
8368 for 3340 

The Access Method Services or JCL can be used for cataloging. 


IS2SIISI Macr o Instri)c ti OD 


In a JES3 loosely-coupled multiprocessing configuration (for exaaple, a 
global processor connected to local or ASP main processors through the 
CTC adapter), the DNIT=CTC option aust be specified fcr all CTC 
devices. 
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SC lj EpU ^.B Hacro Instruction 


JSS3 rs identified as the pi^iBary job entry subsystem by specifying 
PBISUE’=JES3 on the SCHEDULB macro instruction, and is generated by 
specifying the J£S macro instruction. 


lidS£s 


The interface between HVS allocation and the main device scheduler 
function of JES3 (BBS) depends on BPS being able to distinguish class 3 
devices from class 1 and 2. Class 1 devices are those on which volume 
mounting is controlled by MDS. These devices will have the 0CBJES3 bit 
on in their OCB's. Class 2 and 3 devices will not have the UCBJESl bit 
on. The Class 2 devices are described in JES3 initialization DEVICE 
cards (as are Class 1) and represent devices on which permanently 
resident volumes are mounted. Since no volume mounting is required BBS 
provides data set integrity by managed access to nontemporary data sets 
on these volumes. Class 3 devices are those unknown to JESS. The BVS 
allocation routines require that the class 3 devices be contained within 
their own BVS subgeneric groups (that is, class 3 devices cannot be in a 
subgeneric group which contains class 1 or class 2 devices). For 
completeness a brief desription of subgeneric groups follows: 


Subu eneri c Groups 


JESS devices can be grouped by using generic and esoteric names. 

Generic names are defined in the following manner: 

• The lODEVICE system generation macro instruction describes the 
characteristics of an I/C device and its system requirements. The • 
UNIT parameter specifies the gener .c device type (for example, 

3330) . 

• The DNITMABE system generation macio instruction is used to assign 
a name to a collection of I/C devices. The BABE parameter 
specifies the esoteric name to be assigned to the group of devices 
(for example, SVSDA). The UNIT parameter specifies the addresses 
of the devices that will be recognized by the assigned name. In 
order for a device to be referred :o by other than its generic 
name, the device must be specified in the UNITNABE macro 
instruction. 

Generic device types are divided into suogeneric groups as illustrated 
in Figure 3. The existence of subgeneric groups allows BVS allocation to 
serialize on a subset of units within a generic. For example, using the 
figure below, when 3330A is requested, allocation needs to reserve only 
device group #4, rather than all 3330 devices. As a result, more than 
one allocation can process the same generic group as long as the 
allocations require different subgeneric groups within that generic. 

The guidelines by whch the system determines subgeneric groups are: 

• If a user-assigned name (for example, SISDA) includes different 

generic device types, the units in each generic belong to different 
subgeneric groups. 
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• I£ a useE-assigned naie (£oe eiaaple 3330&) includes only a subset of 
the units in a generic, that subset is a distinct subgeneric group. 

• The intersection of any subgroups is a distinct subgeneric group. 

For a aore detailed discussion of MVS allocation and deTice groups refer 
to Coaaon Allocation Control in 0 S/TS2 Scj}edit2s£ SgperY is or {.ggig . 
5128-0625. 


Generic 
Device Type 


Group Naaes 
defined in 
UNITNAHE 
Sysgen cards 


unit Address 


Subgeneric 

Groups 


2400 


181 182 


«1 


2314 


1 ” 

1 SYSDA 


i 

1 SYSDA 


1 


1 3330A 

1 .... 

3330B 'i 

1 


1 f—— 

r ''ll 


131 


• 2 


132 I 133 134 


• 3 


*2 


3330 


151 152 


«4 


153 154 


#5 


L___ 


Figure 3. Subgeneric Groups 


Hhen an esoteric or generic naae io to be aanaged by JES3, one or aore 
of the subgeneric groups that coaprise that naae aust be defined to JES3 
via initialization DEVICE cards. The only restriction is that if one 
unit of a subgeneric group is defined to JESS, then all the units in 
that subgeneric aust be defined. This will prevent a subgeneric group 
froa containing both class 3 devices and class 1 (or class 2) devices. 
Not all of the subgeneric groups of a given naae have to be defined to 
JESS, and therefore, an esoteric oi generic naae can contain class 1, 2 
and 3 devices where a subgeneric gioup cannot. If the number of class 1 
and 2 devices is subject to change (that is, on a shift basis) or future 
expansion is anticipated, additioncl naaes should be generated for each 
desired combination. 
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Siflfil j 2£S3 £fS££S§ING JO ROg GLQfiAi OJLJ 


The following is a saiii{:le JES3 f^ocecaie. 


//lEFPHOC 

//STEFLIB 

//SPOOL 1 

//CHKPNT 

//JES30UT 

//JES3SNAP 

//SISABEKD 

//JESABEND 

//lEFDATA 

//lEFBDER 

//lEFPDST 

//JES3IN 


EXEC PGHalAIINTK 
EE ESN=SYS1.JES3LIB,DISP=CLD 
ED DSN=SYS1.JESPACE,DISP=CLD 
ED DSS=SYS1.JZS3CKPT,DISP=0LD 
ED UNIT=00U,OCS=P11,FCf!=8 
EE U!JIT=AFf =J£S300T 
ED DBII=AFF»JES30UT 
ED DNIT*AFF=JES30UT 
DD DUHHY 
EE EUMHY 

ED DSN^SYSI.XXXX,DISFsSHR 
ED ESN=SYS1.PABMLIE(JES3INC0),DISP»SHR 


where: xxxx is an allocated and unused data set (not PBOCLIB) 


ge seb ajicb 

The procedure to generate OS/VS2 JES2 BBT prograns or workstations in an 
active JES3 system follows: 

1. Make sure that the SYS1.AOSH1, SYSI.A0SH2 and SYS1.ABACLIB data sets 
are cataloged in the generating syitem. 

2. Prepare the options deck for the workstation to be generated. 

3. Issue the JES3 cooDand: *1 INTBDB 

4. Issue the command: S JES2GEH,BODULE=JES3JOB 


System 

Response: 

00 SHASP900 ESTER 
UPDATE OB EHD. 

JES2GES 

OPTICS 

CHARGES, CABDS, 

Enter: 

B 0,6ESCCPJ=YES 




System 

Response: 

00 6ESCCP0 SET TO 

YES 



Enter: 

B 0,SELECT 

=HRTP0FTS 




System 

Response: 

)0 SELiCT SET TO 

BBTPOPTS 



Enter: 

B 0,END 





System 

Response: 

00 $«ASP9C0 ESTER 
UPDATE OB ERE. 

JES2GEH 

OPTICS 

CHANGES, CABDS, 

Enter: 

R 0,6flLEFSIZ=value 





This parameter is used to speci::y the size of the line 
transmission buffer that the workstation will use to send data to 
and receive data from JES3. The buffer size chosen must be the 
same as that specified on the BJPTSBfl card defining this terminal 
to JSS3. 

System Response: 00 &BLBFSIZ SET 10 value 
Enter: B 0 ,SELECT=HBTPxxxx 
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txxx is slthsr of B360, lOlE, SIS3 or 1130, dependiog on the tjpe 
of Morkstatloo to be generated. 

Sjstea Besponse: 00 SILECT SET T1 BBTPzzzx 

Enter: B 0,EID 

Systea Besponse: 00 SBASP950 PLAC3; BBI6EB OPTICBS III OBIT yyy IBS 

BIPLl GO CB C1B:£L 

yyy is the unit address of the card reader. You should sake sure 
that the specified card reader is not being used for any other 
fnnction (a JES3 card reader, for ezaaple). You should clear any 
cards reaaining in the card reider, load the card reader with the 
BBT paraseters, and 

Enter: B 0,GO 

If no BBT generations are kein^ perforned. 

Enter: B 0,CiBCEL 

Bote that the options deck can only specify generation of that type 
of workstation prograa that you selected earlier. You nay generate 
several workstations of that type provided they all use the sane line 
buffer size. If you need to generate workstations of several types 
and buffer sizes rerun step 4 as aany tines as necessary. 

5. Save the asseably listings and the card decks produced. 

6. After all reaote generations are ::oipleted. 

Enter: *C IBTBDB 
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Saiple of a JES2GEH procedure used in a BBT ge&eratioa 


//0ES2GEN 

PBOC 

CLASS^A,flOOULEsJES2JCB 

//GBBEB 

EXEC 

PGH=IEBGEHEB 

//SISPBIMT 

DD 

sisoaT=A 

//SYSUT1 

DC 

CSB^SYSI.PBOCLIE(&HOOOLE)«OISP>SHB 

//SIS0T2 

00 

SXSOOT«(8CLASS,1BIB0B),0CB«BLKSIZE>80 

//SISIH 

00 

OOBBY 


Saaple JES3J0B SIS1.FB0CLIB aeaber: 


//JES3J0B 

JOB 

•GENEBATE 0S/YS2 JES2 BEflOTE BOBKSTATIOBS*, 

// 


HSGLBTELs(1,1),CLASS=A 

//HASPOPT 

EXEC 

PGH-JESIIG£H,B£GI0H=128K 

//STEPLIB 

00 

DSH=SXS1.A0SH1,DISP=SHB * 

//GEHIN 

00 

OHII=2540,DCE=ELKSIZE=80 

//HASPPTF 

00 

DSNsSYS1.A0SH2 (HASPPTF),DISP«SHB 

//SYSIH 

DO 

DSN»SYS1.A0SH2(HASPSBC),OISP«SBB 

//HASPSBC 

00 

DSN=eSC(AACTIYE),DISP-(,PASS),UBIT>SISDA, 

// 


SPACE*(CYL,(12,,2)),DCB=SYS1.BACLIB 

//PTFPBIBT 

00 

S1S0DT=.A 

//SYSPBIHT 

00 

SYSODT=A 

//SYSOOOBP 

00 

£ISOOT=A 

//HASPGEN 

EXEC 

PGB=J£SIIGEH,B£GIOH= I28K 

//STEPLIB 

00 

DSH=SYS1.A0SH1,DISP= ;HB 

//GEHIH 

00 

0»IT=2540,DCE=BLKSIZi=80 

//HASPPTF 

DO 

DSH=SYS1.A0SH2(HASPPTF),DISP=SHB 

//SYSIS 

DD 

CSH=SYS1.A0SB2(HASPSBC),DISP*SBB 

//HASPSBC 

DD 

DSN = 6eC (SACTITE) ,EISF*(OLD,PASS) 

//PTFPBIHT 

DD 

SYSCOT=A 

//SYSPBIHT 

DD 

SYSOOT=A 

//SYSOOOBP 

DO 

SYSCOT=A 

//BHTGEN 

EXEC 

FGM=£XBHTGE)l,BEGION=256K,COHO* ( (0,LT,HASPGEB) ,BTEM) 

//STEPLIB 

DD 

DS1I=SYS1.A0SH1,DISP=SHH 

//GENPDS 

DD 

DSH^eeC(HBTPCPTS),DISP*(OLD,DELETE) 

//SYSIN 

DD 

OHIT*SYSDA,SPACE*(3200,(200,50) ,,,BOOND), 

// 


OCB* (B£CFH=FBS,lB£CL*80,BLKSIZ£*3200) 

//SYSLIB 

DD 

DSH=SYS1.AHACLie,EISP=SBB 

//SYS0T1 

DD 

DSN=66SYSUT1,0KIT=SY3DA,SPACE*(1700,(600,300)) 

//SYS0T2 

DD 

DSH=66SYS0T2,0HIT=SY SDA,SPACE*(1700,(600,300)) 

//SYSUT3 

DO 

DSN=66SYSUT3,01I!;T*SY3DA,SPACE* (1700, (600,300)) 

//SYSPBINT 

EE 

SYSODT=A 

//SYSPOHCH 

CD 

SYS0DT=B 

//SYSGO 

EC 

UHIT=SYSDA,SPACE*(4C0,(100,50) ,,,BOOBD) , 

// 


DC3* (BECFB=FBS,LBECL=80,BLKSI2E=400) 

//CABDIN 

DO 

OmT=2540,DCE=BLKSI2E=80 
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£^1UU3£S 


This chapter supplies the infocBation needed to estiaate the 0S/7S2 
Release 3 storage requiceaents for the J£S3 systea. It also provides 
inforaation about the auxiliary spice necessary to contain the JRS3 
systea. 

Figure 4, Storage Estiaates by Bodule/ provides a table of all JES3 
aodules, their location, their estiaated size, and related coaaents. 
Figure S, Storage Obtained Using A<jETKiIH, provides a table of JESS 
6STE11N usage and associated algorithas needed to estiaate actual 
storage use. The JES3 storage estiaates figures for 0S/TS2 use the 
folloving headings: 

Naae - the JES3 aodule or data area naae. 

Loc ** the storage location of the aodule or data area. The following 
abbreviations are used to idem ify the location: 

PLPA pageable link pack area 

JESS JES3 subpools 0, 251, 252 

Otherwise, the storage subpool nuaber is given. 

Size - the storage size in deciaal. If not specified, the size is 

deterained dynaaically based oh the functions specified in the "jssj 
Initialization/SISGEH algorith < or other considerations" field. 

yg te: In Figure 5, a basic siz ; value is provided in order to 
incorporate the GETHAIN inforaation into the JESS storage estiaate 
suaaary. The size value is subject to large variations based on the 
indicated algorithas. 

Fix - I indicates the nodule is page fixed; H indicates it is not. 
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1037281JSS31 

N 

1 


IIATHDAL 

1025761JE33I 

R 

1 


1 IATMDj3K 

|01872|S31 

R 

1 


1 lATIlEDA 

|02ft88|JES3| 

R 

1 


IIATMELR 

1037441JE33I 

R 

1 


1lAIBDFE 

1014081JES3I 

R 

1 


1lATMDIC 

1062801JESJ 1 

R 

1 


1lATKEMO 

1027281JESJl 

H 

1 


1lAIBEaS 

1018801JESJI 

N 

1 


1lATMDSE 

1098081JES3I 

R 

1 


IIATHDSL 

1038161JESJI 

R 

1 


IIATMDVE 

102416!JZS3I 

R 

1 


1lATMOCS 

102184'JESJI 

N 

1 Loaded for C ... coaaand 


IIATMOCP 

1015 J 61JJS3 1 

R 

|If ♦F J=-,C or *F J=-,P=- 


1lATMOEC 

|01920|JES3I 

H 

1 Loaded for *F R ... coaaand 


1lATMOBL 

1012961JESJI 

N 

Ilf *F L,— 


1lATMODV 

1034641JESJ1 

R 

1 


1lATMOEX 

100968|JBS3| 

N 

ILoaded when HODIFX coaaand processed 


1lATMOGM 

1035201JES3I 

R 

|If *F G,- 


1lATKOHR 

1012721JES3I 

N 

|If *F Q,H or *F U,fi 


IIATMOHR 

1007361JES3I 

N 

ILoaded for *F H ... coaaand 


jlATMCQS 

L 

|06680|JES3I 

X—-L-1- 

N 

1 



Figure 4. storage Estimates by bodule (Part 4 of 6) 
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(JES3 

Systea i.eneration. Initialization 

nodule 

1 Size 

(Loc ( 

Fix 

(or 

Other Variable Considerations 

lATnORJ 

102496 

i JES3( 

N 

T 

1 



lATHOTB 

101816 

(JES3( 

H 

(If 

*F 

£,— 

lATnOVB 

103544 

(J£S3( 

N 

(Loaded for V («VAaX) coiaand 

IITHSCD 

102048 

1 J£S3( 

8 

1 



liTHSCK 

100768 

(J£S3( 

N 

Ilf 

• F 

G,-,i HK 

lATHSDT 

100112 

(J£S3( 

N 

1 



lAXnSGC 

101024 

(JES3( 

N 

1 



lAinSIN 

102152 

(JES3( 

8 

1 



lATHSIO 

104968 

(JSS3( 

M 

1 



lATMSIP 

106920 

(JES3 ( 

N 

1 



lATRSHC 

101840 

(J3S3( 

N 

1 



lATHSKI 

103576 

(JES3 ( 

N 

1 



lATMSHN 

104272 

(JES3( 

8 

1 



lATHSMS 

106936 

(J£S3( 

8 

1 



lATHSHV 

106032 

(JES3( 

8 

1 



lAxnsoi 

(02056 

(J£S3( 

N 

1 



lAiaSPS 

(06040 

(JES3 ( 

8 

1 



IATHSR1 

(01128 

1 J£S3( 

8 

1 



IATHSB2 

(01592 

tJ£S3( 

8 

1 



IATHSR3 

( 00944 

1 JES3( 

8 

1 



lATHSTH 

(01712 

1 JES3 ( 

8 

1 



lATBSVQ 

(03160 

(JES3( 

8 

1 



lATHSVU 

(02200 

(JES3( 

8 

( 



lATSJCH 

(06504 

(J£S3( 

8 

(If 

♦ X 

8JP 

lATSJDJ 

(03248 

(JES3( 

8 

(If 

♦X 

8JP 

IATHJD7 

(00568 

( JES3( 

8 

(If 

♦X 

HJP 

lATNJIC 

(03600 

( JES3 ( 

8 

(If 

*x 

8JP 

lAISJIQ 

(01688 

( JES3( 

8 

|lf 

• X 

8JP 

lATNJOB 

(00496 

(JES3( 

8 

(If 

*1 

8J? 

lAINJOP 

(01944 

( JES3( 

8 

(If 

♦ X 

8JP 

lATSJPD 

(00304 

( JES3( 

8 

(If 

♦X 

8JP 

lATODMH 

(00320 

( J£S3( 

8 

(If 

M¥T TSO 0 tput 

IATODP8 

(00496 

( JES3 ( 

8 

(On 

3 per acti/e punch writer 

lATODPR 

( 00496 

( J£S3( 

8 

(On 

3 per active print writer 

lATODSI 

(01032 

( JES3( 

8 

(One per active writer 

lATOSDH 

(07736 

( JES3( 

8 

1 



lATOSMS 

(01536 

(JES3( 

8 

(If 

BVT TSO output 

lATOSBP 

(03112 

(JES3( 

8 

(If 

processing 8B1TEB coasand 

lATOSPH 

(02464 

( J£S3( 

8 

1 



lAXOSPR 

(03320 

( JES3( 

8 

(If 

print writer is active 

lATOSPS 

(02320 

( JES3( 

8 

1 



lATOSHD 

(07440 

( JES3( 

8 

(If 

writer is active 

lATOSiS 

( 10520 

( JES3( 

8 

1 



lATPURG 

(02096 

( J£S3( 

8 

(If 

purging a job froa sjstea 

lATRJDV 

(01392 

( JES3( 

8 

(If 

*X 

fiJP 

lAXSJm 

(03920 

( JES3( 

8 

|If 

♦X 

BJP 

IAIBJH2 

(04712 

(JES3( 

8 

|If 

♦X 

HJP 

lAXBJHa 

(03984 

( J£S3( 

8 

Iff 

♦X 

BJP 

IATBJB4 

(02304 

( JES3( 

8 

Ilf 

♦X 

BJP 

IATBJB5 

(02304 

( J£S3( 

8 

|If 

*x 

BJP 

lATBJSM 

(01224 

( J£S3( 

8 

Ilf 

•X 

BJPSHPS 

lAXSIBS 

(00336 

(PLPA( 

8 

1 



lATSICA 

(03000 

(P1.PA( 

8 

1 



lATSICF 

(00272 

(PLPA( 

8 

1 



lATSICB 

(00560 

A 

IPLPAI 

1 _ X. 

8 

1 

x_. 
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JES3 Sjstei GeneiatioD, Initialization, 


Module 

i Size 

(Loc ( 

Fix 

(or Other Variabl 

J_ 

u Considerations 

lATSIDH 

107296 

T ""T 

(PLPA( 

M 

T- 




lATSIDO 

100272 

(PLPA( 

M 





lATSItR 

100784 

(FLPA{ 

S 





lATSIJS 

108120 

(PLPA( 

H 





lATSIOP 

100800 

(PLPA ( 

N 





lATSIST 

100720 

(PLPA( 

N 





lATSIVL 

100440 

(PLPA{ 

M 





lATSIWO 

101568 

(PLPA 1 

N 





IATSI34 

100568 

(PLPA( 

N 





lATSSCB 

106720 

(PLPA( 

M 





lATSSDI 

101824 

(PLPA( 

Y 





lATSSDQ 

(00496 

1241 ( 

N 





lATSSJS 

100720 

( J£S3( 

M 





lATSSVT 

100752 

1241 ( 

M 





lATUTCB 

104360 

( JES3( 

N 

(CBPRIKI 

utility 


lATOTCC 

104816 

(JES3 ( 

N 

(Loaded 

when 

DSP 

called 

lATOTCH 

102360 

(JSS3( 

M 

(Loaded 

for console test request 

lATUTCP 

103256 

(JES3 ( 

N 

(Loaded 

when 

DSP 

called 

lATUTCT 

104384 

(JES3( 

M 

1 Loaded 

when 

DSP 

('ailed 

IATUTC1 

101776 

(JES3 ( 

M 





IATUTC2 

i 00664 

(JES3( 

N 





lATUTDC 

108384 

(JES3( 

N 

(If *X DC 



lATUTDD 

102792 

( JES3 ( 

N 

(Loaded 

when 

DSP 

called 

lATUTDS 

107272 

(JES3( 

M 

1 




lATUTPD 

100744 

(JES3( 

N 

(Loaded 

when 

DSP 

called 

lATUTPE 

100568 

(JES3( 

M 

(Loaded 

when 

DSP 

called 

lATUTPI 

(03592 

( JES3 ( 

N 

(Loaded 

when 

DSP 

called 

lATOTf0 

(05208 

(J£S3( 

S 

(Loaded 

when 

DSP 

called 

lATUTPH 

( 00288 

(J£S3( 

N 

1 Loaded 

when 

DSP 

called 

lATUTTC 

(04528 

(JESS ( 

N 

(Loaded 

when 

DSP 

called 

lATOTTD 

(07656 

(J£S3( 

N 

(Loaded 

when 

DSP 

called 

lATUTTL 

(03968 

(JESS ( 

N 

(Loaded 

when 

DSP 

called 

lATUTTI 

(04792 

(JES3( 

N 

(Loaded 

when 

DSP 

called 

IATUX01 

(00040 

(JESS( 

N 

(One per 

Cl subtasic 

IiT0X02 

(00048 

(JESS( 

N 

1 




IAT0X03 

(00040 

(JES3( 

N 

1 




IAT0X04 

(00032 

(JESS( 

M 

[ 




IATUX05 

(00032 

(JESS( 

N 

1 




IAT0X06 

(00032 

(J£S3( 

N 

1 




IATUX07 

(00032 

(JESS( 

N 

( 




IATUX0& 

(00032 

(JES3( 

N 

1 




IATUX09 

(00032 

(JESS( 

N 

( 




IATUX10 

(00032 

(JZS3( 

8 

1 




lATlJX11 

(00032 

(J£S3( 

N 

1 




IAT0X15 

(00032 

(JES3( 

H 





lATUXIb 

(00104 

1JES3I 

N 

1 




IAT0X17 

(00104 

(JBS3( 

N 

1 




lATUXIb 

(01736 

(JESS( 

N 

1 




lATUXIS 

(00040 

(J£S3( 

N 

( 




IATUX20 

(01936 

(JESSj 

N 

( 




IA'IUX21 

(02008 

{JESS ( 

S 

( 




IATUX22 

(00040 

(JES3( 

N 

1 




IATUX23 

(02880 

(JES3( 

H 

1 




IATl)X24 

(00048 

(JES3( 

N 

1 




IA1:0X25 

(00160 

(JESJ ( 

8 

(If verify of 

HSl 

tape required 

IATUX26 

(00040 

{PLPA( 

N 

1 





X_L 


Figure 4. Storage Sstiaates by Module (Part 6 of 6) 
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1 Nodule 
i Issuing 
IGETHAIN 

1 Size 

1 Loc 

IIATUX27 

100104 

1JES3 

IIATQX28 

100104 

IJES3 

IIATUX29 

100104 

1JES3 

IIA1UX30 

100104 

1JES3 

IIATNAN 

|002d6 

1JES3 

IIATNGN 

100256 

1JES3 

IIATRHN 

100256 

1 JES3 

IIATNPN 

100256 

1JES3 

IIATKON 

100256 

1JES3 

1lATWQSC 

100256 

1JES3 

IIATNRN 

100256 

1JES3 

IIATHSN 

100256 

1JES3 

1 lATHTN 

100256 

1JES3 

IIATHXN 

100256 

1JES3 

IIATHYN 

100256 

1JES3 

1IATINM2 

100512 

1JES3 

1 lATINGN 

100512 

1JES3 

IIATINGN 

100512 

1 JES3 

IlATINGN 

100512 

1 JES3 

IIATGRAN 

100512 

1 JES3 

IIATINGN 

100512 

1JES3 

1lATBCOS 

100512 

1 JES3 

IIATIIPR 

100512 

1 JES3 

1 lATINGN 

100512 

1 JES3 

IIATINGN 

101792 

1 JSS3 

1lATINGN 

100512 

1 JES3 

IIATOSPS 

100512 

1JES3 

1 lATUTCP 

100512 

IJES3 

IIATOTPO 

100512 

1JES3 

1lATOTTD 

100512 

1JES3 

1lATINGN 

100512 

1 JES3 

IIATINR2 

100512 

1JES3 

IIATINGN 

1 00512 

1JES3 

IIATLVIN 

105000 

1 JES3 

1lATLVIN 

100512 

1 JES3 

IIATLVIN 

100100 

1JES3 

IIATHDSE 

100512 

1JES3 

IIATBDSB 

100512 

1 JESS 

IIATINII 

100512 

1000 

IIATISNT 

100512 

1000 

IIATIS3T 

100512 

1000 

IIATUTTD 

100512 

1000 

IIATUTTD 

100512 

|000 

1IATINC2 

100512 

1000 

IIATINC2 

100512 

1000 

IIATINC2 

100512 

1000 

IIATINII 

100512 

1000 

IIATINII 

100512 

1000 

IIATIICA 

108192 

1000 

Figure 5 

. Storage 


JSS3 Systen GeneidtioQ, Initialization, 
or ether Variable Consxderations 


If AN print iaage translate is required 

If GN print inage translate is required 

If HM print mage translate is required 

If PN print iaage translate is required 

If CN print image translate is required 

If QNC prin-: image translate is required 
If BN print image translate is required 

If SN print image translate is required 

If TM print image translate is required 

If XN print image translate is required 

If YN print image translate is required 

48(no. DEVPOOLS)*12(no. dedicated devices) 
16'«-8*(no. of DEACLINS cards) 

8 (no. of DEACLINE cards 1) 

392*(no. of pre-alloc. FCT on BESCTLB) 

16(active J3S3SEWS data sets) 

4+12* (no. NJPTSBH cards)*24*(no. of NJP lines) 
24(active output alias naaes) 

PiSS/CATLG DSN reference 

184* (no. of pre-alloc. BQ on BESCTLBK) 

48(36 SYSOUT classes) 

24 (no. acti^fe SET PBINT requests) 

24 (no. active SET P8INI requests) 

24 (no. active SET PRINT requests) 

24 (no. active SET PBINT requests) 

8+(100* (no. of printers ♦no. of punches)) ♦ 
68* (no. of all other device cards) 

6+(46* (no. of BJPLINE cards ♦ no. of BJPTEBB 
cards)) 

16* (no. of dedicated printer buffers) ♦ 
(BDFSIZE)* (no. of dedicated printer buffers) 

Size of LOCATE response (aax. 4K) 

4K*((8+(no. of allocated data sets ♦ (11 ♦ 
size of DSN)))/4K) 

4K*((10+(no. of known managed vol. ♦ 24))/4K) 

Determined by nc. of PBOC cards 

JES3 buffer size (one per each net with device 

fencing) 

66* (no. of job retworks) 

16 (no. of files) 

Blocksize+1 of input tape file(s) 

1C4^(100(no. of CONSOLE cards)) 

160 (no. buffers on CONSBOF para) 

48 (no. of CONSOIE cards) 

Deterained by no. of BESDSN cards 
iDeterained by no. of UMSHABE cards 
I Variable size; blocks of 4K each 


Storage Obtained Using A6ETHAIN (Part 1 of 2) 
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N 
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1lATGHG 1 
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N 
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N 
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100720 
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N 
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i 00108 
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N 
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N 
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1 

N 
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1 12288 
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1 

N 
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1 

a 

1 


1lATINSV 

140960 

( 231 
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1 
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1 00512 
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1 

N 
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1 

N 
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1 

N 

(50K or STXTNT on MAINPROC 
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1 

N 
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100512 
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N 
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(245 
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N 
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( 245 
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N 

j44(tota protected buffers/2) 


IIATINC2 

(00512 

(254 
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N 

(136 (no. of JES3 devices) 
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(00512 
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1 

N 

(80* (no. of started RJP lines) 
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(254 

1 

N 

1 
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j2£S3 STOBAGE ESSIHATE SOHM AHY 


Basic CSECT Bequireneot 452k 
Dynaaic CSECT Beguireae&t 331k 
PLPA CSECT Beguireaeot 47k 
Basic Sttbpool 000 43k 
Basic Sabpool 230 Ik 
Basic Sabpool 231 52k 
Basic Subpool 241 58k 
Basic Subpool 245 2k 
Basic Subpool 254 Ik 


JIS3 A DIILI ABY SIQBASI ilfiOIHEBISlS fBIQO IHE Dl 


The following describes the auxiliary space necessary to contain the JESS 
systea. SYS1.JESPACE is used as a spool voluae to store all job input, 
job output, JESS control blocks, and systea data such as the job journal. 
SYS1.JES3CKPI is used for Checkpoint/Bestart. 

//SP0CL1 EC DSII=SYS1.JESPACE,DISP=0LE 

(Dynamic as large as you want it, but must be contiguous) 

//CHKPNT ED DSII=SYS1.JES3CKPT,DISP=OLD 

(Only one cylinder SXSEA reguired) 


J|S3 A UXI LIAHI STOHAGE RECUIEEBENTS (CECIONAL) 


The following describes the library concatenations reguired for MVT and or 
SVS main processors. SYS1.JES3BI contains the Beader/Interpreter nodules 
which are shown below. SYS1.JES3LIB contains all of the JESS code except 
the subsystem interface modules that reside in SYSI.LPALIB and is 
described in more detail in "DATASET Macro Instruction" and "Systea 
Generation Macro Instructions". 

//lATBILB EE DSN=SYS 1.JES3HI,DISP = SHB 

(Load module library for BI modules) 

// ED DSN=SYS1.JES3LIB,DISP=0LD 
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lATRILB COKTENTS 

The following table describes the two libraries that aay be defined in the 
JES3 procedure with the ddnaae of lATBILB. One of these libraries oust be 
defined if you will be running eithtc MVT or SVS aain processors, or 
both. The SVS library aust be used if any of the aain processors are 
running SVS. If these libraries are used, they aust be authorized. 


BVT READEB/INTEHPBETEB MODULES 


MODULE NAME 

DECIMAL SIZE 

^LIAS FOB 

COMMENT 

IEFHHFK2 

- 

lEFMVTHB 

MVT ONLY 

lEFMVTHH 

4536 


MVT ONLY 

lEFMVTHB 

1224 


MVT ONLY 

lEFMVTJA 

6192 


MVT ONLY 

IEFVGM1-19 

5016 



IEFVGM70-71 

480 



IEFVGa78 

248 



lEFVHA 

34688 



lEFVBCB 

- 

lEFVHA 


lEFVHF 

- 

lEFVHA 


lEFVHM 

- 

lEFMVTHH 

MVT ONLY 

lEFVHN 

1600 



lEFVHBEP 

- 

lEFVHA 

MVT ONLY 

IEFVH1 

5160 



lEFVINA 

6040 



lEFVJA 

- 

lEFMVTJA 

MVT ONLY 

lEZDCOOE 

208 


MVT ONLY 


SVS BEADZB/IHTbBFBETEB MODULES 


HODULE HISI filCIM^L SJZE lil/iS FOB COMMENT 


lEFVAMP 80 SVS 0 iLI 

lEFVDMI 5120 SVS ONLY 

lEFVGK - lEFVHA SVS ONLY 

IEFVGM1-19 5016 

IEFVGM70-71 480 

1EFVGM78 248 

lEFVHA 34688 

lEFVHCB - IEF7EA 

lEFVHF - lEF/HA 

lEFVHB 1600 

IEFVH1 5160 

lEFVIBA 6040 

If running SVS aain processor, the following 

changes aust be applied using the AMASPZAP service aid prograa: 

NAME lEFVHA lEFVFA 

VEB 03F0 BFF7F14D,4780B41E 

REP 03F0 4700F14D,47F0B41E 

NAME IEFVH1 

VEB 0194 4720B0FC 

REP 0194 4700 


Storage Estiaates 35 








nma isioshmioh 


System danageient Facilities (SHF) is a feature of OS/VS that provides 
the Beans for gathering and recording infornation that can be used for 
evaluating systea usage. InforBation is collected by SHF data 
collection routines and user-vritten t’Zit routines. 

The JES3 SHF fecords presented in thi.* chapter is in addition to SHF 
inforaation found in OS/VS Sy stem Hant g en ent Faci li ties (SHF), 
GC35-0004. 
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BECOBD TYPE 6 • OUTPUT HBITEB 


Becord type 6 is writteo for each data set processed by JES3 output 
service. A record is written for ^ach copy with a given fora naae. The 
record length is 100 bytes. The foraat is shown in Figure 6. 


1 Displaceaent 

1 Dec Hex 

Field 

Size 

_ 

1 Data 

1 Foraat 

1 

1 

-4— 

Contents 

1 

0 

1 

0 

1 

1 binary 

1 

System indicator 

1 


1 



1 

1 

Bit Henning When Set 

1 


1 



1 

1 

6 VS2 

1 

1 

1 

1 

1 

1 binary 

1 

Becord type 

1 

2 

1 

2 

4 

1 binary 

1 

Tine, in hundredths of a second. 

1 


1 



1 

1 

record was moved to SHF buffer 

1 

6 

1 

6 

4 

1 packed 

1 

Date record was aoved to SHF 

1 


1 



1 

1 

buffer, in the fora 00Y7DDDF, 

1 


1 



1 

1 

where F is the sign 

1 

10 

1 

A 

4 

1 EBCDIC 

1 

System identification 

1 

14 

1 

E 

8 

1 EBCDIC 

1 

Job naae 

1 

22 

1 

16 

4 

1 binary 

1 

Time, in hundredths of a second, that 

1 


1 



1 

1 

the reader recognized the JCB card 

1 


1 



1 

1 

for this job. 

1 

26 

1 

1A 

4 

1 packed 

1 

Cate that the reader recognized the 

1 


1 



1 

1 

JCB card for this job, in the fora 

1 


1 



1 

1 

OOYYDDDF 

1 

30 

1 

IE 

8 

1 EBCDIC 

1 

User-identification field froa conaon 

1 


1 



1 

1 

exit paraaeter area 

1 

38 

1 

26 

1 

1 EBCDIC 

1 

Output HTB Class (blank if non-SYSOUT) 

1 

39 

1 

27 

4 

1 binary 

1 

Output BTR start tine 

1 

43 

1 

2B 

4 

1 packed 

1 

Output BTR start date 

1 

47 

1 

2F 

4 

1 binary 

1 

Munber of records written by the 

1 


1 



1 

1 

writer, by fora nuaber and by class. 

1 


1 



1 

1 

includes repeats and restarts 

1 

51 

1 

33 

1 

1 binary 

1 

I/C status indicator 

1 


1 



1 

1 

Ej,t Beasisa B^en Set 

1 


1 



1 

1 

0-4 ieserved 

1 


1 



1 

1 

5 Data input error 

1 


1 



1 

1 

6 Reserved 

1 


1 



1 

1 

7 Control block input error 

Figure 

6 

(Part 

1 of 2) . 

Becord 

Tjpe 6 
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r" 

Cisplacesent 

1 

Field 

1 Data 

1 




Dec 

Hex 

1 

Size 

1 Foiaat 

_L 

1 

1 

Contents 



52 


-T" 

1 

1 

1 

1 birary 

1 

"T* 

1 

Total nuBber of data sets processed 





1 

1 


1 

1 

by Output RTR and included in this 
record. (Count for each tiie 


1 




1 

1 


1 

1 

1 

1 

a data set is printed.) Does not 
include restarts. 



53 

35 

1 

4 

1 EECDIC 

1 

Fora nuaber 



57 

39 

1 

1 

1 binary 

1 

Reserved 



58 

3A 

1 

2 

1 binary 

1 

Subsystea generating ID 





1 


1 

1 

Ya^ue Meaning 





1 

1 

1 


1 

1 

1 

1 

1 

1 

0 EXT-WTR 

2 JES2 

5 JES3 



60 

3C 

1 

2 

1 binary 

1 

Length of this section, including 





1 


1 

1 

this field 



62 

3E 

1 

2 

1 binary 

1 

Data set control indicators 





1 


1 

1 

Bit Heaning When Set 





1 

1 


1 

1 

1 

1 

0 Reserved 

1 Record represents spun off 





1 


1 

1 

data sets 





1 


1 

1 

2 Operator terainated this data 





1 


1 

1 

group 





1 


1 

1 

3 Operator interrupted this 





1 


t 

1 

data group 





1 


1 

1 

4 Operator restarted this data 





1 


1 

1 

group 





1 


1 

1 

5 Record represents continuation 





1 


1 

1 

of interrupted data group 





1 


1 

1 

6 Operator overrode programaed 





1 


1 

1 

printer carriage control 





1 

1 


1 

1 

1 

1 

7 Punch output was interpreted 

8-15 Reserved 



64 

40 

1 

4 

1 EBCDIC 

1 

JES assigned job nuaber 



68 

44 

1 

8 

1 EBCDIC 

1 

JES logical output device name 



76 

4C 

1 

4 

1 EBCDIC 

1 

ECB identifier 



80 

50 

1 

4 

1 EBCDIC 

1 

OCS idenrifier 



84 

54 

1 

4 

1 binary 

1 

Approximate page count. (Skip to 





1 

1 

1 


1 

1 

1 

1 

1 

1 

carriage control channel one 
counted as a page.) For punch data 
sets, the nuaber of cards punched. 



88 

58 

1 

2 

1 binary 

1 

1 

Data format error indicators 





1 

1 


1 

1 

Bit Meaning When Set 

0-5 Reserved 


1 




1 


1 

I 

6 Some first character control 





1 


1 

1 

data bad, default used 





1 


1 

1 

8-15 lieserved 



90 

5A 

1 

2 

1 biniry 

1 

Output priority 



92 

5C 

1 

8 

1 EBCDIC 

1 

Logical Output device group name 

-J 

Figure 

> (Part 

2 

Of 2) . 

Record 

Type 6 
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HICORD TYPE 25 - JOE ALLCCATIOSS 


Record type 25 is written for each job processed by the aain device 
scheduler. A record is written for each static or dynaiic allocation 
and for each group of private catalog allocation reguests. The record 
length is 38 bytes, plus the length of the descriptor section. The 
foraat is shown in Figure 7. 


r“ 

Cisplacesent 
Dec Hex 

1 

1 

Field 

Size 

1 Data 

1 Foraat 

1 

1 

Contents 

"T 


0 

0 

1 

1 

1 

1 binary 

T 

1 

Systea indicator 





1 


1 

1 

Heaninq Bh§n Set 





1 


1 

1 

6 VS2 



1 

1 

1 

1 

1 binary 

1 

Record type 



2 

2 

1 

4 

1 binary 

1 

Tiae, in hundredths of a second. 





1 


1 

1 

record was aoved to SHF buffer 



6 

6 

1 

4 

1 packed 

1 

Date record was aoved to SHF buffer. 





1 


1 

1 

in the fora OOIYDDDF, where F is the 





1 


1 

1 

sign 



10 

A 

1 

4 

1 EBCDIC 

1 

Systea identification 




E 

1 

8 

1 EBCDIC 

1 

Job naae 



22 

16 

1 

4 

1 binary 

1 

Tiae, in hundredths of a second, that 





1 


1 

1 

the reader recognized the JOB card 





1 


1 

1 

for this job 



26 

1A 

1 

4 

1 packed 

1 

Date that the reader recognized the 





1 


1 

1 

JOE card for this job, in the 





1 


1 

1 

fora OOYYDCDF 



30 

IE 

1 

8 

1 EBCDIC 

1 

Oser-identification field 


u 








.J 


Figure 7 (Part 1 of 2). 


Record Type 25 
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Descriptor Section 


Displaceaent | Field 
Dec Hex | Size 



Data 

Foraat 


binary 


binary 

binary 

binary 

packed 

binary 

packed 

binary 

binary 

binary 


packed 


binary 

packed 


Contiints 

Functiotf Flags 
l±t Meani ng 

0 1 - dynasic allocation 

0 - static JCL allocation 

1 1 - catalog allocation 

0 - execution allocation 

2 1 - autoaatic allocation 
0 - annual allocation 

3-15 Reserved 

Ruaber of tape voluaes fetched 
Muaber of disk voluaes fetched 
Tiae of day, in hundredths of a 
second, fetch processing started 
Date, in the fora OOYIDDDF, where F 
is the sign, fetch processing started 
Tiae *S S comaand issued 
(zero if autoaatic allocation) 

Date *S S coaaand issued 
(zero if autoaatic allocation) 

Nuaber of tape voluaes aounted 
Kuaber of disk voluaes aounted 
Time of first voluae aount aessage 
(tiae of JSS3 allocation if no 
aounts) 

Date of first voluae aount aessage 
(tine of JES3 allocation if no 
aounts) 

Tine of JES3 device verification 
Date of JES3 device verification 


Figure 7 (Part 2 of 2). Record Type 25 
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BECOBE TYPE 26 - JOE POBGE 


Becord type 26 is uritten at jcb purje alter all SYJCUT for the job has 
been processed. The length is 50 bytes, plus the length of the 
descriptor, events, and actuals sections The ■inimuB length is 232 
bytes. 

The job is identified by job log number, programmer's name, and J£S job 
number. Operating information includes the stapt and stop time for 
processing of the job by the reader, execution and SYSOUT output phases, 
JES logical input device name and output statistics. The format is 
shown in Figure 6. 


r- 

1 

1 

Displacement 
Dec Hex 

1 Field 

1 Size 

_L... . 

1 Data 

1 Format 

1 

1 

Contents 


1 

0 

1 

0 

1 

1 2 

1 binary 

•T* 

1 

fiecorc length 


1 

2 

1 

2 

1 2 

1 binary 

1 

Segment discriptor 


1 

4 

1 

4 

1 1 

1 binary 

1 

System indicator 


1 


1 


1 

1 

1 

Bit He^Ding When Set 


1 


1 


1 

1 

1 

6 VS2 


1 

5 

1 

5 

1 1 

1 binary 

1 

Becord type 


1 

6 

1 

6 

1 4 

1 binary 

1 

Time, ls hundredths of a second. 


1 


1 


1 

1 

1 

recor i was moved to SHF buffer 


1 

10 

1 

10 

I 4 

1 packed 

1 

Date racord was moved to SHF buffer. 


1 


1 


1 

1 

1 

in th ! form OOYYEDDF, where F is the 


1 


1 


1 

1 

1 

sign 


I 

14 

1 

A 

1 4 

1 EBCDIC 

1 

System identification 


1 

18 

1 

£ 

1 8 

1 EBCDIC 

1 

Job name 


1 

26 

1 

16 

1 4 

1 binary 

1 

Time, in hundredths of a second, that 


1 


1 


1 

1 

1 

the reader recognized the JCB card 


1 


1 


1 

1 

1 

for this job 


1 

30 

1 

1A 

1 4 

1 packed 

\ 

Date that the reader recognized the 


1 


1 


1 

1 

1 

JCB card for this gob, in the 


1 


1 


1 

1 

1 

form OOYYDDDF 


1 

34 

1 

IE 

1 8 

1 EBCDIC 

1 

User-identification field 


1 

42 

1 

26 

1 4 

1 binary 

1 

Reserved 


1 

46 

1 

2A 

1 2 

1 binary 

1 

Subsystem identification 


1 


1 


1 

1 

1 

laise 


1 


1 


1 

1 

1 

2 JES2 


1 


1 


1 

1 

1 

5 JES3 


1 

46 

1 

2C 

1 2 

1 binary 

1 

Section indicator 


1 


1 


1 

1 

1 

Sii Ifess 


1 


1 


1 

1 

1 

0 Descriptor section present 


1 


1 


1 

1 

1 

1 Events section present 


1 


1 


1 

1 

1 

2 Actuals section present 


1 


1 


1 

1 

1 

3-15 Reserved 


Figure 

8 

(Part 

1 of 3) . 

Becord 

Type 26 
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Descriptoc Section 



Displacenent 
Dec Hex 

1 

1 

Field 

Size 

1 Data 

I Format 
* 

1 

1 

Contents 

—1 







1 

•T" 




0 

1 


1 

2 

1 binary 

1 

Length of descriptor section. 




1 


1 


1 

1 

including this field 



2 

1 


1 

2 

1 binary 

1 

Reserved 



4 

1 


1 

1 

1 binary 

1 

Job information 




1 


1 


1 

1 

Bit Meaning ihen Set 




1 


1 


1 

1 

0 DJC job 




1 


1 


1 

1 

1 Deadlined job 




1 


1 


1 

1 

2 Job met deadline 




1 


1 


1 

1 

3 Process job 




1 


1 


1 

1 

4 Job left system via HJP 




1 


1 


1 

1 

5 Job entered system via NJP 




1 


1 


1 

1 

6 Job was dumped via DJ 




1 


1 


1 

1 

7 Job was entered via DJ 



5 

1 


1 

1 

1 binary 

1 

Jcb information 




1 


1 


1 

1 

lit leaning Wisn set 




1 


1 


1 

1 

0 Priority from priority on 




1 


1 


1 

1 

JOB card 




1 


1 


1 

1 

1 SETUP job 




1 


1 


1 

1 

2 Job held via TIPBUI1=HCLD 




1 


1 


1 

1 

3-4 Reserved 




1 


1 


1 

I 

5 Job entered via internal 




1 


1 


1 

1 

6 Job was rerun on main reader 




1 


1 


1 

1 

7 Job was canceled by the 




1 


t 


1 

1 

operator 



6 

1 


1 

4 

1 EBCDIC 

1 

JES3 assign ;d job number 



10 

1 


1 

8 

1 

1 

Job ID - is job number 




1 


1 


1 

1 

ID Meaning 




1 


1 


1 

1 

JCBORNRH Normal job 




1 


1 


1 

1 

STCONMNN Started task control 




1 


1 


1 

1 

TSUONNMM ISO user 



18 

1 


1 

20 

1 EBCDIC 

1 

Programmer's name from JOB card 



38 

1 


\ 

1 

1 EBCDIC 

t 

MSGCLASS from JCB card 



39 

1 


1 

1 

1 EBCDIC 

1 

Job class from JOB card 



40 

1 


1 

1 

1 binary 

1 

Initial job priority 



41 

1 


1 

1 

1 binary 

1 

Job selection priority 



42 

1 


1 

4 

1 binary 

1 

Reserve d 



46 

1 


1 

8 

1 EBCDIC 

1 

Input device ddname 




1 


1 


1 

1 

User IL if TSO submit 




1 


1 


1 

1 

System name if NJP 



54 

1 


1 

8 

1 binary 

1 

Reserved 



62 

1 


1 

4 

1 binary 

1 

Estimated execution time 



66 

1 


1 

4 

1 binary 

1 

Estimated output lines 



70 

1 


1 

4 

1 binary 

1 

Estimated output cards 



74 

1 


1 

1 

1 EBCDIC 

1 

Deadline schedule type 



75 

1 


1 

3 

1 binary 

1 

Reserve! 



78 

1 


1 

8 

1 EBCDIC 

1 

Input d ;vice group name 



86 

1 


1 

8 

1 EBCDIC 

1 

Procedu ;e DD name 



94 

1 


1 

8 

1 EBCDIC 

1 

System job sent to via NJP 



102 

1 


1 

8 

1 EBCDIC 

1 

System job received from via NJP 



110 

1 


1 

8 

1 EBCDIC 

1 

ID of d ^pendent job net to which 




1 


1 


1 

1 

job belongs (//♦NET) 



118 

1 


1 

4 

1 binary 

1 

Deadline schedule time 



122 

1 


1 

4 

1 binary 

1 

Deadline schedule date 


1. 

126 

1 


1 

8 

1 EBCDIC 

1 

Job class name 

1 

Figure 

8 

(Part 

2 

Of 3) 

lecotd 

Type 26 
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Events Section 


r‘ 

Cisplaceaent 

Field 

1 Data 

1 



Dec 

Rex 

Size 

t Foiffiat 

1 

Contents 


0 

1 

1 

2 

T-—— 

1 binary 
i 

-T- 

1 

1 

Length of events section, including 
this field 


2 


2 

1 binary 

1 

Beserved 


4 


4 

1 binary 

1 

Reader stop tiae 


8 


4 

1 pacited 

1 

Beader stop date 


12 

1 

4 

1 binary 

1 

Converter start tiae 


1b 

1 

4 

1 packed 

1 

Converter start date 


20 

1 

4 

1 binary 

1 

Converter stop tiae 


24 

1 

4 

1 packed 

1 

Converter stop date 


28 

1 

4 

1 binary 

1 

Execution start tiae 


32 

1 

4 

1 packed 

1 

Execution start date 


36 

1 

4 

1 binary 

i 

Execution stop tiae 


40 

1 

4 

1 packed 

1 

Execution stop date 


44 

1 

4 

1 binary 

1 

Output processor start tiae 


48 

1 

4 

1 packed 

1 

Output processor start date 


52 

1 

4- 

I binary 

1 

Output processor stop tiae 

C- 

56 

1 

4 

t packed 

1 

Output processor stop date 


Actuals Section 


r— 

0 1 

1 

1 2 

1 

1 binary 

1 

1 

1 

Length of actuals section, including 
this field 


2 1 

1 2 

1 binary 

1 

Beserved 


4 1 

1 

1 

1 

1 binary 

1 

1 

1 

Number of input cards for job 
(JCL and data) 


s 1 

1 4 

1 binary 

1 

Output lines to spool 


12 1 

1 4 

1 binary 

1 

Output cards to spool 


16 1 

1 4 

1 EBCDIC 

1 

Input processor systea ID 


20 1 

1 4 

1 EBCDIC 

1 

JCL conversion processor system ID 


24 I 

1 4 

1 EBCDIC 

1 

Execution processor system IB 


28 1 

1 4 

1 EBCDIC 

1 

Output processor systea ID 


32 1 

1 8 

1 EBCDIC 

1 

Failed step naae 


40 1 

1 8 

1 EBCDIC 

1 

Failed proc naae 

t— 

48 1 

1 4 

1 binary 

1 

Condition Code 


Figure 8 (Part 3 of 3). Becord Type 26 
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BECOBD TYPE 43 - SOESYSTEH STiBT 


Becord type 43 contaios JES3 Jinforaation at the tiae JES3 is started. 
The record is writteo during JES3 initialization. The record length is 
38 bytes. The foraat is shown in Figure 9. 


Displaceaent | Field 
Dec Hex I Size 



Data 

Foraat 


binary 


binary 

binary 

packed 


EBCDIC 

binary 

binary 

binary 

binary 

binary 



1 



1 

1 

7 Dynaaic 

23 

1 

17 

1 

1 binary 

1 

Beserved 

24 

1 

18 

1 

1 binary 

1 

Beserved 

25 

1 

19 

1 

1 EBCDIC 

1 

Initialization 

26 

1 

1 

U 

8 

1 EBCDIC 

1 

1 

1 

Initialization 
Type Origin 


EBCDIC 


Contents 

Systei indicator 
Bi4 SbeS Set 

6 VS2 
Becori. type 

Tiae, in hundredths of a second, 
reco d was aoved to SHF buffer 
Date ecord was aoved to SHF buffer, 
in the fora OOYYDCEF, where F is 
the sign 

System identification 
Subsystea identification 
X'0005' signifies JIS3 
Beser red 
Beser red 
Beser red 

Start record flags 
Bi t Heaning Hhen Set 

0 Cold start 

1 Harm start 

2 Hot start 

3 Queue analysis required 

4 Global systea 

5 Local systea 

6 Besierved 


Heaber naae (JCL default) 
Meaber naae (CP choice) 
Unit address (OP choice) 


JESS procedure naae 


Figure 9. Becord Type 43 
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RECORD TYPE 


SUBSYSTEM STOP 


Record type 45 contains JZS3 inforaaticn at the tine JES3 is stopped. 
The record is written daring JES3 teroination. The record length is 26 
bytes. The format is shown in Figure 10. 


i Displacement 

1 Dec Hex 

Field 

Size 

1 Data 

1 Format 

1 

1 

Contents 

1 ■ 

0 

0 

1 

1 binary 

•T- 

1 

System indicator 





1 

1 

flSASina 





1 

1 

6 VS2 


1 

1 

1 

1 binary 

1 

Record type 


2 

2 

4 

1 binary 

1 

lime, in hundredths of a second. 





1 

1 

record was moved to SHF buffer 


6 

6 

4 

1 packed 

1 

Date record was moved to SHF buffer. 





1 

1 

in the fora GOYIDDDF, where F is 





1 

1 

the sign 


10 

A 

4 

1 EBCDIC 

1 

System identification 


14 

E 

2 

1 binary 

1 

Subsystem identification 





1 

1 

X'0C05' signifies JESS 


16 

10 

2 

1 binary 

1 

Reserved 


18 

12 

2 

j binary 

1 

Reserved 


20 

14 

1 

1 

1 

Stop record flags 





1 

1 

Sii Hhen Set 





1 

1 

( Subsystem ended due 





1 

1 

to abend 





1 

1 

1 DSI has been invoked 


21 

15 

3 

1 binary 

1 

Completion Code (SYS/OSER) 


24 

18 

1 

1 

1 

Reserved 


25 

19 

1 

1 

1 

Initialization deck origin type 


Figure 10. Record Type 45 
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BSCOBO TYPE 47 - SIGHCB/SIABT LIHE 


Becord type 47 (TS2 only) is vritten by JES3 BJP under tvo conditions: 
(1) Nhen a BJP line is started, and (2) when a renote user signs on. The 
length is 22 bytes, plus the length of the identification and aessage 
sections. 

This record contains the recorl type, tine staap (tine and date), CPO 
Identification, JES3 subsysten event, renote nane, line nane, password, 
and nessage text. The fornat is shown in Figure 11. 


r~ ~ 

1 Displacement 

1 Dec Bex 

Field 

Sixe 

1 

1 

Data 

Fornat 

- - ^ - ^ 

Contents 

0 

"I 

0 

1 

•T“ 

binary 

' 

Systen indicator 




1 


Sii Set 




1 


6 VS2 

1 

1 

1 

1 

binary 

Becord type 

2 

2 

4 

1 

binary 

Tine, in hundredths of a second. 




1 


record was noved to SMF buffer 

6 

6 

4 

1 

packed 

Date record was noved to SHF buffer. 




1 


in the forn OOYYDDCf, where F is 




1 


the ;ign 

10 

A 

4 

1 

EBCDIC 

Systei identification 

14 

E 

2 


binary 

Subsysten identification 






X'00)5* signifies JESS 

16 

10 

2 

1 

binary 

Beser /ed 

18 

12 

2 

1 

binary 

Lengti of remainder of record, not 




1 


including this field 

20 

14 

2 

1 

binary 

JESS SIGMOM/Start Line subsystem 




1 


event - X'CCOI' signifies SIGMOB 

1_ 



1 


X*0002' signifies Start Line 

Identification Section 

i 0 


2 

1 

binary 

Length of identification section. 




1 


including this field 

1 2 


8 

1 

EBCDIC 

Benote name 

1 10 


8 

1 

EBCDIC 

Line nane 

1 18 

L __ 


8 

1 

EBCDIC 

Password 


Message Section (will not appear if this is the start of a line record) 

I 0 I I 2 binary | Length of SIGHON message section, 

I I I I I includin') this field 

I 2 j I 36 I EBCDIC I Message text. (If this is a SIGNON 

I I I I i record, infornaticn from colunns 35 

I I I I I through 70 of the SIGMON card inage 

It I I (is placed in this field.) 


Figure 11. Becord Type 47 


46 <ISS3 Belease Guide (7S2 Belease 3) 

















BECOBE TYPE 4b - SIGNCFF/STOr LINZ 


Becord type 4b (T52 only) is ifiitten by JES3 when a BJP line tecainates 
o£ when a reaot^ user signs off. The length is 7S bytes. 

This record contains the record type, tine stasp (tine and date), CPU 
identification, JES3 subsystem event, renote naae, line naae, password, 
and suanary of data and error activity. The foraat is shown in Figure 
12 . 
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BECOBO TYPE 49 - JES3 IHTEGBIIY 


Becord type 49 is a duplicate of record type 47 except the password say 
not be valid, and the event type aay be one of four codes, fhis record 
is written when an invalid SIGBCB :!S atteapted. The length is 22 bytes, 
plus the length of the identification and lessctge section. 

This record contains the record type, tine staiip (tiae and date), CFO 
identification, JES3 subsystea eveat, renote naae, line naae, password 
(invalid), and aessage text. The foraat is shown in figure 13. 
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CHECKPOIMT/BESTiHI IfiFOBMATIOS 


Checkpoint/Bestart is a technique for recording inform3t;.on about a job 
at prcgramaer-designated checkpoints so that, if necessary, the job can 
be restarted at one of these checkpoints or at the b.eginning of a job 
step. 

The checkpoint/restart inforaation for JES3 presented in this chapter is 
in addition to checkpoint/restart inforaation found in 0^/ YS 
Checkp oin t/Bestart. GC26-378'4. The topics covered in this chapter ate; 

• Restarting a Job 

• Operator Restart Considerations 

• Job Journal Data Set Osage 


SESTAHTISG a jce 


When a job step abnornally terminates, you may have to resubmit the job 
for execution; this means delay and lest computer tine. The operating 
system provides restart facilities to reduce the effects of abnormal 
termination. 

There are three types of restarts: 

• Step restart, from the begi ining of i jot step. 

• Checkpoint restart, from a checKpoint within a job step. Checkpoints 
are established in a job step by coding the CHKPT macro instruction 
for each checkpoint desired. A checkpoint is taken when a user 
program issues the CHKPT macro instruction. This macro causes the 
ccnten'.c of the program's virtual-storage area and certain system 
control information to be written as a series of records in a data 
set. These records can then be retrieved from the data set if the job 
terminates abnornally or produces erroneous output, and the job can be 
restarted. Restart can take place immediately (initiated by the 
operator at the console) or he deferred until the jcb is resubnitted. 
In either case, the time-consuming alternative of rerunning an entire 
job is eliminated. 

The CHKPT macro is described in OS/ TS Dat§ Hanaaenen t M acro 
inst ructi ens. GC26-3793. See also the DD CHKPT parameter in 0 S/yS2 
JCL, GC28-C692. It specifies that checkpoints are to be taken at end 
of volume for the data set defined by the DC statement on which it is 
coded. 

• System failure restart, by specifying the FAILOHE=BESTABT parameter on 
the JES3 //♦MAIN statement. In the event the job cannot complete 
executing because of system failure and the job is not eligible for 
H7S automatic restart, JESj will automatically reschedule the job from 
the beginning. Other optic ns on the FAILUBE parameter are CAMCEI., 
HOLD, and PRINT. All of tl a values are described on the MAIN FAILOBE 
parameter in the section, in 0S/ YS2 J CL , GC28-0692. 

Whether using step restart oi checkpoint restart, the restart facility 
can be automatic or defected. 
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Auto aatic Rest art ; To use autoaatic restart, code the BD (restart 
definition) parameter on the JOB or EZEC statement. JESS creates a job 
journal for any job specifying the BD parameter. (A job journal is 
established to hold restart information for each program in execution.) 
Rhen a system failure occurs or a job step abnormally terminates and you 
have a job journal, the restart facility allows automatic restart when 
RE=B is coded on. the JOB or EXEC statements. If checkpoints are taken, 
ycu can automatically restart at the last checkpoint regardless of 
whether or not the BO parameter is coded. Rhen a job step abnormally 
terminates or a system failure occurs while the job is in execution and 
the installation has not implemented job journaling, these jobs are 
ineligible for automatic restart. 

Pg;ggpre d Re start; To use deferred restart, code the BESTABT parameter 
on the JOB statement. This required parameter specifies a job step or a 
step of a cataloged procedure and can specify a checkpoint identifier if 
you are using deferred checkpoint restart. The effect of the parameter 
is simply to restart the job at the beginning of t.he specified step or 
checkpoint. The SYSCHK ED statement is required ihen a job is being 
submitted for deferred checkpoint restart and mus- be placed immediately 
after a JOBilB ED statement. 

Jobs B ann ing on ASP Main Processors; The HAIN JOE STEP parameter 
specifies the job step checkpoint option for jobs on ASP main processors 
only. The checkpoint option will not be taken if JOBSTEP=NOCHKPNT is 
coded or if nothing is coded; the checkpoint will be taken at the end of 
each job step if JCBSTEP=CHKPNT is coded. If a checkpoint is requested, 
it means that the user can see the output up through the last completely 
executed step if a system failure occurs and the job is not restarted. 
Otherwise, there is no goh-producec' output. The WAIN JOBSTEP parameter 
is ignored in HVS; the job step checkpoint feature is standard. The 
automatic and deferred restart facilities described above are not 
available tc jobs running on ASF main processors. 

Refer to OS^VS Checkpoint^Restart, GC26-3784, foi a complete description 
of planning for and using the checkpoint restart facility. 


OPERATOR RESTART CONSIEERATIONS 


A job may be abnormally terminated as a result of a hardware, 
programming, or system error. Such an error may occur any time during 
execution and could cost the loss of valuable machine time. The 
checkpoint/restart feature of the system is provided to allow a restart 
of an abnormally ended job either at the beginning of a job step or at a 
checkpoint within this step. The programmer determines whether an 
automatic restart or a deferred restart is to be performed. 


AUTOMATIC RESTART 


If the programmer provides for an automitic restart and the job does 
abnormally end, you will receive messaga IEF225D asking if the indicated 
jot should restart. The message may indicate the checkpoint id, thus 
allowing you to prevent repeated restarts at the same checkpoint or job 
step. When you are requested to authorize an automatic restart, you can 
reply YES, HOLE, or NC. 

• Reply YES if the restart is to be performed at a specific checkpoint 
or job step for the first time. If a step restart is tc occur and the 
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step to be restarted used a card input data iet that uas not part of 
the SKSIJI streaa, you Bust return all cards read by the job step 
before it ended abnormally to the apj:opriate hoppers. If a checkpoint 
restart is to occur, follow "he proyraBoer's instructacns for 
replacing the input cards. 

• Reply HOLD if you want to defer the restart; for example, to permit 
another job to be run first. You must enter the *HCCIF1 coBBand with 
the release operand when you are ready to restart the job. also, if 
desired, you may cancel the job. However, canceling the got may 
result in unrecoverable pay ng space or the failure of certain data 
sets to be deleted if virtual I/c is being used. 

• Reply NO if no restart is to be performed. When you reply NC, and the 
programaer wants a restart \o be performed, he must resubmit the job 
for a deferred restart. 

When VsB is specified, the restart may be delayed by the system waiting 
for the allocation of storage. If another job is using the required 
storage, you will not receive a message - only a delay. Enter a DISPLAY 
A command to see if a system task or other job is using the storage 
required by a job with a V=fi region. You may stop or cancel the 
conflicting task or job. The system Bay ask you to mount data volumes 
other than these required at the beginning of the job. The job's I/O 
will be set up by JES3 for the first job step, not the step being 
restarted. Canceling a job in a dependent network will prevent 
successor jobs from executing if they are dependent upon successful 
completing of the canceled job. 

Note; Any operator commands in the input stream of the job step being 
restarted will not be executed. 


DEFERRED RESTART 


If the programmer provides for a deferred restart and the job does 
abnoraally end, the job must be resubmitted to have this restart 
performed. To restart the job, the programmer must provide a restart 
deck for submission to the system through the system input reader. The 
JCL statements to be included are described in detail in the publication 
QS^:i52 JCL, GC28-0692. ^ 

The device configuration of the sy.steB at the time of restart need not 
be the same as it was when the job was abnormally ended. However, 
enough devices must be available ti satisfy the needs of the job step 
being restarted. The system under which a step restart is run need not 
be the sane as it was for the job's original execution. However, a 
checkpoint restart should be run u ider the original system unless the 
alternate system can meet the following restrictions: 

• The release number is the sane. 

• The link pack area Bodules in us- at the checkpoint Bust reside in the 
saBe storage locations. 

• Jobs specifying ?=H require an area of storage identical to the 
original area. 

If the required storage is not available, the system will cancel the 
restart and you will receive nessage IEF2091 which states that virtual 
storage is unavailable for the job. 

If the required storage is not available, it is for one of the following 
reasons: 
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• The link pack area expands into the regained storage. This lay occar 
if an initial prograa loading has been perforaed after the original 
execution of the job and prior to the restart. If this does occur, 
contact the systea prograaaer for a respecification of the systea 
paraaeters and repeat initial prograa loading using the new values. 

• The systea queue area expands into the required storage. When this 
occurs, contact the systea prograaaer for a respecification paraaetet 
and repeat initial prograa loading using the neu SQl value. 

When a job restarts correctly, you will receive two aessages: IHJ0061 
and IHJ0061. If, for T^B jobs, these aessages do not appear, enter a 
DISPLiX A coaaand to see if a systea task or other job is using the 
required storage. You can then step or cancel the conflicting job. 

The systea nay ask that you nount voluaes other than those required at 
the beginning of the gob. The jeb's I/O will be initially setup by J£S3 
for the first job step, not the step being restarted. In addition, any 
card input data sets that have been used by the failing job step aust 
again be aade available to the systea. 

Restart of JES3 controlled jobs aay be accoapanied by aessages IAT2006 
and/or IAT2 575. Refer to OS^VS ? eggas i JIS3 flSSSSilgSf 

GC38-1012 for response to the ne;sages . 


JCB JOUEOt Uhlh SET USAGE 


The job journal is a sequential ata set that resides on the spool 
voluae of JESJ. Unique to VS2, ts function is to contain a set of 
selected job-related control bio* ks that are critical to autoaatic 
restart processing. In 03/360 M T systeas, the informaticn now in the 
job journal was available for re: tart processing from the SYS 1.SYSJOBQE 
data set. 

The jcb journal is necessary bee. use VS2 maintains its scheduler control 
blocks in the scheduler work are. (SWA) in pageable storaae, rather than 
on a job queue on external storat e. When a job or the system fails, 
there is a resultant loss cf the address space that contains the SWA and 
its job control blocks. Because it preserves up-to-date copies of 
certain critical control blocks, the jcb journal makes it possible to 
reconstruct the SWA. SWA contro:. blocks will be reconstructed to their 
state just prior to the failing ; tep for automatic step restart. For 
automatic checkpoint restart the: will be reconstructed as they appeared 
at the most recent issued CHKPT. Thii capability is available for the 
following kinds of restart; 

• Automatic step restart 

• Automatic checkpoint restart 

• System restart (including completioi of job ct step termination) 

Therefore, if a gob does not have job journaling, autoaatic restarts 
cannot be used. 

Jcb journaling is provided to a jot i JEcJ in one of three ways: 

• The gob class of the jci has regues ed journaling (JCUBBAL=YEi on the 
CLASS initialization st tcaent) . 

• The jot has a //•RAIN c-id with JCU NAL=YES ov.rriding the got class 
table. 
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• Iha job’s JCL has eiti.ex. BZ3TAHT= on tne JCE stateaent or HD= on the 
JCE or EXEC Etdteaent. 

After a systea failure and JES3 restart of the failing main processor, 
those jobs in execution that had requested job journalinq will be BVS 
system restarted (or uarsstaited). If a 30 b is eligible for HVS 
automatic restart, the operator will be sent message I:eF 22 SD asking if 
the job should restart. If the job is not eligible for restart, or the 
operator indicates t>at restart should not be attempted, any scratch or 
VIO data sets the jcl had aliocated will be deleted 'and the 30 b will be 
terminated. Therefore it ma} be desirable for certain classes of jobs 
which make a significant use of scratch and/or VIC data sets to request 
job journaling. 


Jfisj £H|CK|oj|t jbisa S£i 


The JZS3 checkpoint data set provides the capability for warnstarting or 
hotstarting the JES3 system with minimum or no loss of system 
information. In the restart process, validation of checkpointed 
information occurs with instances where one or more user-submitted jobs 
may be canceled as a result of ii.valid data. The typical situation will 
be no loss of system information. 

The J2S3 checkpoint facility is implemented by writing job-related 
control block information to the J£S3 checkpoint data set at appropriate 
points in time during system processing. That is, as information 
changes in the system. 

The JESS checkpoint data set contains oheckpointed information as 
defined by the lATYCKP macro. TJis macro defines the job control table 
(lATYJCT) head and taxi pointer ,ile description blocks (IDEs) for the 
sixteen JCT priority levels rept' seating the JES3 job queue. From the 
JCT, the JES3 30 b related contro. blocks can be accessed in order to 
perform JES3 job processing. In addition to the JCT, file description 
blocks for special JES3 job processing facilities are checkpointed as 
follows; 

• (lain Device Scheduler Volume Or avail able Table -- this table contains 
volume serial numbers of volumes una/ailable to HDS processing. 

• Output Service -- checkpoint record containing three FDBs required to 
checkpoint the Output Service I river nodule (that is, the lATYJDi, 
lATYJDS, and lATYCSE control blocks). 

• Deadline Scheduling -- containr a checkpoint of the Deadline 
Scheduling Queue control blocks. 

• JES3 HEWS -- checkpoint of the JES3HEWS data set. 

• TSONEWS -- checkpoint of the T5CNEWC data set. 

• BJPHEiS -- checkpoint of the B. PHEHS data set. 

• Generalized Wain Scheduling — used to checkpoint GMS Selection nodes. 
Execution resources and various GMS parameters. 

• Device Fencing — checkpoint ol the device fencing control blocks. 

• Dependent Job Control — checkpoint of the lATYHCK control blocks 
which contain the net control block FDBs. 

• Main Device Schedule — checkpoint of the online/offline status of 
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devices eligible for setup. 

• Systea Farasetecs -- oiscellaneous paraae^ers cbeckpoioted in the 
lATYCKP ccntrol block are; 

- Last job nunber assigned in the systea 

- One-half the size of the Track Allocation Table 

- Nuaber of gueue extents 

- Single track allocation table 

- JCT priority hold flags 

The JES3 checkpoint area is allocated to a unique data set and is 
managed via the EACF macro instruction. A user of the checkpoint ar 
causes a checkpoint to be taken by issuing the JESCRFST aacro. 
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£CD|S 


The routing and descriptor codes, user coapletion codes, and systei 
coipletion codes for JES3 are presented in the topics that follow. This 
section contains inforsation that is in addition to that found in CS/VS 
SSSSSSS L4^tary; VS2 Syjgtga Codes, GC38-1008. 


gOfillliG AND DgSCRJfTfiS CODgS 


Route codes and descriptor codes ire specified in the BODICES and DSSC 
paraeeters of the NTO/RTOB nacro nstruction. Inforoation contained in 
this chapter is in addition to ro iting and descriptor code inforoation 
found in Qg/gg fiSSSfiRS ^ifiRtin^ and £s§cra£Aor ££des, 

GC38-1004. 

The following routing and descrip.or codes, shown in figure 14, are used 
by oessages issued during JE53 in..tiallzation and teroination. 
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Figure 14. Routing and Descriptoj Codes Used During Initialization 


Codes 55 








After JES3 ioitialization, routing and descriptor codes are ispleaented 
by a JES3 subsystea interface routine that exaaines the BCOtCDE and DESC 
paraaeters specified with WTO aacro instructions. 

Messages are directed by JES3 to the appropriate JES3 and/or DCS console 
device. In the event no BOUICDE is used JES3 assuaes a route code of 

2 . 


SySTEM COMPLEIION CODES 

JES3 uses the following systea coapleticm codes: 

JZS 

EXPLMiTlON: (Bhen caused by lATLBEE) 

• The data set has been closed and the user is still atteapting to 

perforn I/C - IAT1601 pointed to by register 15. 

• The lATYDSB and lATXSVT control Mocks were not valid - IiTl602. 

• Invalid function code passed - IjtTl603. 

• Error return fron a start I/O operation in the user's address space - 
IAT1604 and IAT1605. 

• lATYDAT address not within a correct address range - IAT1606. 

• Could not allocate an unprotected buffer for a POINT operation - 

IAT1607. 

• Hhile atteapting to set up a data aanageaent BAIT, a data nanagement 
function was currently waiting - IAT1609. 

• While atteapting to set up a subfystea interface BAIT, a subsystea 
function was currently waiting - IAT1609. 

• An invalid lATIDAT was found on the DAT Queue. 

• An invalid unprotected buffer adcress was found - IAT1608. 

SYSTEM AC TION: The step is terminated. 

SSERATOR_RESPC}!SE: None. 

PROGRAMMEH_BESFCNS|: Take problea to-your systems programmer. Supply a 

SYSABEND~dumpT "correct any invalid I/O operations within your program. 

• Serun the job with a SYSABSND DD card if 

necessary. 

BCDULE: lATDMEB 

SilinaATICS: (Bhen caused by lATSIIM) 

• No JDSENTBY was found when an attempt was made to update it during 
unallocation - IAT6700. 

• Error occurred in the disk MRCH cllocator routine when trying to open 
the data set - IATo702. 
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• A catastrophic error occurred 3D the global processor while 
atteipting coaeunication - IAT6703. 

• A user aeacry buffer could not be allocated to a data set during OPEN 
- IAT6704. 

• No core was available for global interface for external writer data 
set - IAT6706. 

• Unable to find OSE at unallocation for external writer - IAT6707. 

• Permanent I/O error encountered on an output data set - IAI6708. 

• Bad data was sent to global via a SSISEBf. Bequest could not be 
serviced - IAT6711. 

user aeaory is terainated. 

None. 

£fifiii££££££-££££S£££*• Take problem to your systems prograaaer. Supply a 

SySABIND duap. 

£S2E±lfl_££TEBJBIJiAlI0N: Berun the job with a SYSABENB DD card if 

necessary. 


ifl 

EXPLAN ATION ; The JES3 address sp^ce has abnormally terminated. There 
are two environments in which tbi: error may occur; 

1. A critical error has occurred .arly in JES3 initialization or late in 
JESS termination. The JESS ES'.'AE has not yet been set and no JESS 
formatted ABEND duap is available. 

2. Once JESS initialization has completed up to the point where the JESS 
ESTAE exit (lATABMN is the exi . routine) has successfully been 
established, this abend code i;; used by lATAEBN (the Failsoft 
Monitor) to return to the ESTAi; exit level for various reasons in 
order to be able to issue a SE'BE macro iiStruction. 

One reason is to produce an OS/MVS duap, which will therefore always 
appear as a S2FE regardless of the original abend code. The original 
abend code is shown in the Failure Logout »IAT3713 messages to the 
operator) and in the JESS formatted dump. The occurance of an S2FB 
dump by itself does not tell yet whether the failing JES3 function 
could recover or had to be terminated. 

An OS/MVS duap with an abend code of S2FB means that lATABMN or a 
routine employed by lATABMN failed and thereby produced that abend 
code. JESS was terminated as a result of that. 

S1STEM_ACTICN; 

1. Message IAT3702 is written to the operator and to the (JESS 
initialization) specified dump data set. This message details 
certain critical debugging information that is needed in analyzing 
the problem. An abend dump of the type specified in the JESS 
initialization deck is taken. 

Of ER ATC3/£P£ij«|MM£|_SElP0JjSE: 

1. Refer to the explanation of the indicated IAT3nnn message for 

information on the cause of the error and necessary remedial action. 
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2. The abend duisp that is produced she aid be reviewed/analyzed for the 
cause of the error. If a DUHFnnn ]s indicated, refer to the sumnary 
of the JES3 DUMP errors for furthei information. 

£8CBLEM_DETEfiMINATICS: 

Table I, items 2, 5, 16. See OS^VSi Message Library; JES3 Messaejes, 
3C38-1012. 

Table III, items 4, 5, 6, 20. See CS^VS2 Message Library: J ES 3 
Mess ages . GC36-1012. 

MCDULE: 

1. As indicated for the IAT3nnn messaga. 

2. lATNUC (csect lATAEMN); service for all DSPs. 

3IB 

SX£LANATION: 

• Could not obtain enough storage in SP=241 to build a DSB. 

• Could not obtain enough storac-e in SP=241 to create a fiA£. 

SYSTEM AC TIOM; The user memory xs teiminated. 

OPERATOR RSSPOSSE; None. 

PROGRA MMER RESPONSE: Take the problem to a systems programmer. 

PROBLEM DE TERMINATICN: Rerun the job rfith a SYSABESD DD card if 
necessary. Problem may not reoccur. 

MCDULE NAME; lATSIDM 

4FB 

£X£LASAIIOjS: 

• Unable to obtain sufficient storage in SP=241 for SSISEHV. 

• Unable to obtain sufficient storage in SP=230 for user memory 
buffers. 

• Error processing ICE for additional track groups. 

SYSTEM A CTION; The user memory is terainated. 

OPERAT OR RESPONSE: None. 

PROGRA MMER RESPCNSE; Take the pioblem to a systems programmer. 

PBgELEH_D|TEEMINATION: Rerun the job uith a SISAEEND ED card if 

necessary. Problem may not reoccur. 

IIS 

EXPLANATION; The error occured during the execution of an MVS-JESS 
allocation subsystem interface routine. B15 has a program loaded abend 
code to uniquely identify the cause ol the abend. The codes are: 
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1 In coomon allocation tie nuuber of units to be allocated by JES3 
does not equal the nuacer requested by MVS. 

2 Unable tc successfully issue an ESTAE durinq deallocation 
processing. 

3 Unable to obtain storage for a dynamic allocation buffer. 

4 Unable to obtain storage for a change DDNAME Duffer. 

5 Unable tc find the address space ID associated with the request in 
any of the raenory headers. 

6 JST point error occured during conmon allocation or deallocation. 
For Code 1: B3-units requested, B5-units passed. 

For Codes 2,3,4,6: B3 has the macro BIN code. 

For Code 5: R2-A(JSCB), B3-Address space ID. 

SYSTEM ACTION: The affected task is terminated. 
pROGHA MME R B^SPONSE: None. 

PROBLE M DE TEBMIMj^IION: Table I, Iteus 1, 3, 5A, 15, 16, 29. See OS /Y S 
Megg^ge LiJ^rgry: JESJ Messages, GC36-1012 


6 fB 

EAPLARA TI ON: Register 15 contains a reason code in the hi-order byte 
and a return code in the low-order byte. 

Reason Code 0 

Subsystem Interface Common Services has detected an error in its calling 
parameters or in the system status. Return codes are: 

24 The caller of SSICS is not in a system protect key 0-7. 

28 The main processor specified by SYSID in the SSIS3RV macro is not 
defined. 

32 An invalid combination of fields SELECBF, SELEXIT, SELBUFF was 
found in the lATISEL c mtrol block for a WAIT or REPLY TYPE 
SSISERV request. 

36 An error was detected attempting to write a staging area. 

40 The primary and all secondary staging area extents have been 
exhausted. 

Reason Code 1 

An error return was taken from JES3 macro lATXEGM or lATXEFM. See JES3 
macros manual for explanation of return codes. 

Return codes are: 

8 GETMAIN/FBEEHAIN failed 

Reason Code 2 

An error return was taken from MVS FREECELL macro. See MVS macros 
manual for detailed explanation of return codes. 

Return codes are: 
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8 cell address is invalid 
12 no cell pool 
16 invalid cell pool id 

Season Code 3 

An error return was taken froa MVS BLDCPCCL aac^o. See MVS aacros 
manual for detailed explanation of return codes. 

Return codes are: 

4 GETMAIN failed 
8 invalid cell pool id 
12 non-glotal subpool 
16 cell size greater than pool size 

Reason Code 4 

An error return was taken from fVS GETCELL macro. See MVS aacros manual 
for detailed explanation of return codes. 

Return codes are; 

8 chain pointers destroyed 
12 no cell pool 
16 invalid cell pool id 

SYSTEB_ACTICN: A dump of CSA, SQk, and the HVS trace table is taken to 

a SYsl,DUMp'data set and the curcent memory is abended. 

NOTE; If the current memory is IES3, an error return is taken to JES3. 
The calling DSP is then abended <ith a DB014 abend code. 

OPEBj^TO B RE SPONSE: Restart system if JES3 has abended. 

£HOsaAMIS_£iSPCNSE: Eor Reason Code 0 refer to the SSISSRV macro for 

an explanation of lATYSEL specifications. 

PROBLEM DETEBBINATICN: 

Table I, item 2. Table III, items 1, 4. See OS^VS Messaae Library: 
JS33 Kessavjes, GC38-1012 

MODULE: lATSSCfl 


jfS 

A catastrophic error occurred during the execution of the 
MVS-JES3 dynamic device reconfiguration (DDR) subsystem interface 
routines. 

SYSTpM AC TION: The swap is terminated. 

OPER^TOR_BESPONSE: If the swap was operator initiated, retry. If the 

swap was system initiated, no action is requited. 

PBgGEABME3_EZSECN3S: None. 

PRCELSM DETEEBINATICN: Table I, Items 5A, 16, 29. 


Mil 

EXPLANATION: t\a err'-r has accurred in one of the Interpreter Service 
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noD-J£S3 supFort areas. 

Register 15 contains the return code: 

5 An error has occurred in the Initiator Queue Manager Interpreter 
Interface (lAIIIII). Register 9 points to a work area which will 
have foraatted aessages in it (IAT<l901,2<3} . 

6 An error has occurred in a USAS ICIHI or RBITE operation out of an 
interpreter subtask. 

7 An invalid DSB error in USAC initialization processing out of an 
interpreter subtask. 

8 An error has occurred in u;JAB buffer initialization out of an 
interpreter subtask. 

15 An invalid return froa the OS Beader/Interpreter has occurred. A 
duap is taken to SYSI.OOUP and the current task is detached. 
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DJUMIC SUE£0£T SYST^d (£SS) INICSBAIIQS 


DSS is a debugging tool that lEH i^rograa Systen Bepcesentatives and 
user-authorized personnel can use to identify and provide teaporary 
corrections to software errors in the operating systea (OS/TS). 
inforoaticD presented below is in addition to that found in 

GC28-06h0. 

ASP nain processors running HVT or VS2-1 should have the CTC aonitor 
inactivated when CSS is used on the global JSS3 processor to prevent 
being disconnected. Ihe following coaaand will prevent aain task 
monitoring of the CTC; 

*T nain-ptoc-naie,F BT,P»C 
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ISi 12 JES3 BIGBIIIOS AJD 


An ASE to J£S3 BigcatiOD aid, available with an appropriately updated 
level of ASP Version 3.1 and above, allows access of an ASP support 
processor to a global JES3 HT3 processor. The aigration aid allows 
production testing of a JES3 systei while the balance of the work is 
handled by the ASP systei. Vhen a job terminates, output can be printed 
by the JESS global processor or returned to the ASP support processor. 
The aid consists of two callable DSPs. One executes under ASP Version 
3.1 on an existing ASP support processor (ASPAID) and the other executes 
under JESS cn the global processor (JESAID). CTC support routines are 
also provided. Each ESP will coamunicate with the opposite processor by 
a coBBon CTC device. The aid permits the operator on the ASP system to 
select jobs to be routed to the JESS system based on class, group, point 
of origin, user specified parameter, or exit routine. The jobs are 
routed to JESS for input processing, execution, and output processing, 
or may be routed for execution only, and returned to the ASP system for 
output processing. 

ASPAID enables gob selection based on operator, installation or user 
specifications, provides post JESJ processing options and supports the 
ASP side of the CTC adapter connection with the JES3 system. 

JESAID supports the JESj side of the CTC adapter and provides reader and 
writer services. 


|;2M1I0NAL OVEEVIES 


JES3 EROCESSGB 


Module lATADJP is scheduled for execution via an operator call to the 
JESAID DSP (*X JESAID). 


lATADJP interfaces with the JES3 operator to initialize, modify or 
terminate JESAID functions, responds to reader and writer requests, and 
services the CTC for data transfer and interrupt handling operations. 


fisadsi ilflfiissing 


All jobs submitted via the JESAID reader are assigned a job origin of 
"ASPSys." SISOUT data generated ny jobs whose origin is "ASPSYS" will 
be queued by output service for the JESAID writer device type unless a 
valid JES3 destination is specified by a //*FCaaAT card or SYSOUT DD 
specification or SYSCUT class card definition. SYSOOI data queued for a 
valid JESJ destination is processed by the JESJ output service writers. 
SYSOUT data queued for the JESAI) device type is selected by the JESAID 
writer and returned to the ASP s/stem, via the CTC, for ASP PRINT, 

PUNCH, ACES, etc. processing. 
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Pr ocessing 


The JESAIE writer is a "hot writer". It is posted by output service 
whenever SYSOD'I output is queued for the JESAID device type. Bata sets 
are selected using the lATiOSWS macro. Each data set selected is 
transmitted tc the ASP system and written by ASP module AIEADAP into the 
JES/MRF for the associated job. 

The JESAIE writer transmits a data set open message providing ASP module 
AIDABAP with the required information to locate or create a JDS entry 
and initialize a HHF with an ASP header record. A "write-tape-mark" 
control write initiated by JES3 module lATADJP signals "end-of-file" to 
ASP for the data set being transmitted. 

Data sets unable to be successfully transmitted to ASP are requeued for 
JES3 processing based cn the alternate destination selected by the 
operator. 


ASP PEOCESSOB 


Module ASPAID is scheduled for execution via an operator call to the 
ASPAID DSP (*X ASPAID). 

ASPAIE interfaces with the AS? operator to initialize, modify or 
terminate ASPAID functit'n, handles ASP- IDADAP communications, monitor 
the job flow to/from th( JSS system, an< determine a job's post-JES 
processing requirements on the ASP systim. 


INITIALIZATION PROCESSING 


JES3 Initialization 


During JES3 initialization, each processor defined via a MAINPBOC 
control card as SYSTEM=ASPAD will have a main service control block 
structure built as though an MVT/VS2.1 ASP main had been defined with 
the following exceptions: 

• The associated CTC UCB will not be initialialized with the sense 
SRE/IOSB. 

• The MPCDATA Csect will be chained only from the SVT. Any processor 
defined as "SySTEM=ASPAD" will be known only to the JESAID CTC for 
data transfer and interrupt hanlling operations. 

The JES3 initialization deck must contain the following tc permit JESAID 
reader, writer and CTC processing: 

• A DEVICE card defining the GROUP and DEVICE name to be associated 
with the JESAID reader and writer. ’he DTYPE must be AID and the 
DGROUP must be ASPSYS. 

Example: 

DEVICE DTYPE=AID,JNAME=AIEREH, BGBOU ?=A SP S Y S , J UNIT- (NONE ,S Y1 ,,OH) 
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• k KAINPfiCC and DEVICE card defining the CTC adapter used to 

coamunicate aitb the ASP syst-:3. The ''SYSTEM" paraaeter on the 
MAINPBOC card must be "ASPAE”. JES3 initialization will initialize 
the reguired control blocks and tables but the defined processor will 
only be known to the JESAIE DSP. 

Example: 

DEVICZ,DTYPE = SY3KAIN,JNAME = SYAIE, JUSIT= (4B0,SY 1,,CfF) 
MAINPRCC,NABE=SYiIE,5YSTEM=ASPAE,ADAPTER=4B0, 

CTCCUA= (1,2) ,HAIMCTC = 4B0 

The CTCCUA paraaeter is required but need not reference SYSGEBed 
devices. The above example assumes that SY1 is defined as a global 
JES3 processor. 

During JES3 Initialization, "SYSTSM=ASPAD'' processors are handled 
somewhat like "SYSTEK=ASP*' processors. Therefore, JES3 module 
lATINJE expects an IPL text file to be included in the J2S3 
initialization deck. If no otner "BVT/VS2.1" systems are defined to 
JES3, a dummy lEL text file is needed to satisfy the lATINJB 
requirement. 

Example; The following satisfies the dummy IPL text requirement. 

* 

• dummy ipl text for asp processor 
ipl,end 


ASP Initialization 


The JES3 system must be defined :o ASP as a real main processor via the 
appropriate MAINPBCC and DEVICE :ards in the ASP initialization deck. 

The defined system may be used a; an ASP remote main (M?T or VS2.1) 
until such time as it is initial .zed as a JES3 processor. Otherwise it 
should be set offline at ASP ini lialization time. Only those devices 
required for use as a real ASP miin need be defined to this processor. 

The ASP MAIN, when initialized a; a JES3 processor must be offline, with 
all functions terminated. This offline status will be maintained while 
A3PAID is active. MAINIO for specified main will be disabled until the 
ASPAID is terminated. 


INPUT SERVICE PBr'-.ESSING 


Pr oc essing 


JES3 module lATISMN ignores all valid "JESOPT" parameters on //♦HAIN 
cards but will flush all jobs with in'alid syntax in a "JESOPT" 
parameter. ASP input service will no-.: queue any jobs for transmission 
to JES3 if errors are found while processing a "JESOPT" parameter. 
Therefore, the presence of an error in a "JESOPT" parameter indicates a 
job origin other than the ASP system. Additionally, "JESOPT" syntax 
errors may impact the proper handling of subsequent //•HAIN card 
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paraneters. 


AiE Pro ce ssing 


ISMAIS scans the JESOPT paraaeter on the //♦MAIN card for aigration 
scheduling options. 

//♦MAIN [JES0PT={n| (n, 3 ,s,M) ]] 

n - specifies the scheduling option if the job coapletes noraally on 
the JE5 system. 

j - specifies the scheduling option if the job does not complete 
processing (that is, not thru main) on the JES system, 
s - specifies the scheduling option if the JES system fails and is 
subsequently COLD STARTED. 

M - if specified, requests that the job be migrated. 

The options for the n, j, and s parameters are: 

R - reschedule the jcb for the JES SE (valid only for the s parm) 

A - run on the ASP system (if specified for DJC, jobs mill default to 
0 ) 

0 - schedule only the output lSPs and PURGE 
C - schedule only for PURGE piocessing on the ASP system 

Example; The following JSSOPT pai imetei causes ASPJOB to be transmitted 
to JES3 fcr processing and Purged on ASP if completed on JES3 or run on 
ASP if incomplete on JES3 or run n ASP if the JES3 system fails. 

//ASPJOB JOB ,AARDVARK 
//♦MAIN JESOPT= (0,A,A,M) 

// EXEC PG«=XYZ 

The following DSPs are defined as OUTPUT processors (that is, processors 
to be scheduled when *0* is speci ied) : PRINT, PUNCH, and ACDS. 
Additional DSPs may be defined as OUTPUT processors for post-JES3 
processing by using the OUTPUT (0 TP0T=yes) parameter in the DSPDC macro 
for the selected DSP in HESPARAM. 

ISJES, after the ASPAID DSP has b. en called, selects jobs to be sent to 
the JES system based on the ORIGI , CLASS, or GBOUI specified on the 
ASPAID call or subsequent START, ir when specified on the //♦MAIN card 
(for example, //*MAIN JES0PT=(,, M)). 

The transmission of DJC jobs is d> pendent on the first job entered for a 
given net. If the first job of a net is sent to JES3, all subsequent 
jobs for the net are sent to the . ES3 system. If the first job is not 
sent to d£S3, subsequent jots for the let are not selected for 
transmission. Nets sent to JES3 will only be allowed to process output 
on the ASP system. 

A user exit is provided tc cverriue tht above selection criteria. This 
is accomplished by setting/cleariny th< ISAIDFL ISJMGRT flag. If the 
selection criteria in the exit causes jartial DJC nets to be sent to the 
JES3 system, the results are unpndict; ble. 

Jcbs submitted with an ertoi in t .e JESOPT parameter cn the //♦MAIN card 
ate not sent to the JES3 sy;tem. Jcbs specifically requesting migration 
are held to allow the operator to run cr cancel thi; jcb on the ASP 
system if ASPAID has not betn cal ed. The status of a job selected for 
transmission to JES3 cannot be al ered via ASP "moiify" once input 
service processing for the :ob is complete. 
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JSS PBOCESSISG (ASP) 


Jobs to be sent to JES3 are cbeduled ‘ot transaission in a manner akin 
to main scheduling, if ASPAI is activited. A RSSQUEUE (BQ) entry is 
built for each job to be sen . to JES3 ind added to the BC chain and 
JESBC subchain, tihen a BQ El is retut led for the transmitted job, JSS 
marks the apfropriate SB's coaplete to the job based on the code 
returned by the ASPAIE DSP for the job . The return cede is based on the 
lost JES3 processing options selected. 


OUTPUT SEBVICE PROCESSING (JSS3) 


During OSE construction, JES3 module lATOSDB determines if the 
destination requested for jobs whose job origin is ASPSYS is a valid 
JES3 destination and queues all SYSODT data sets with invalid JES3 
destinations as though no destination had been specified. (SXSOUT data 
sets are queued for a device within the sane GBOUP as the job’s input 
origin device.) 

Therefore, SYSOUT data to be transmitted back to the ASP system can be 
selected by a writer that processes SYSOUT data for an output device 
within the ''ASPSYS'' GBCOP of devices. 


PURGE PROCESSING(JESS) 


JES3 module lATPUBG issues an INISBCOH macro directed to the JESAID DSP 
during the Purge processing of each job whose job origin is “ASPSYS". 

The text of the message contains the terminating JESS job number and a 
flag byte defining the termination status of the job (such as JCl error, 
ABEND, or operator cancel). 

Upon receipt of this message, JESJ module lATADJP converts it to the 
format expected by the ASPAID DSF and transmits it to ASP module AIDADAP 
as a console message which is roited by AIDADAP tc the ASPAID DSP. 

ASPAID uses the message content to determine post JIS3 processing 
requirements within the ASP systta. 

Example: 

JES3 job number 0102 as completed J££3 processing normally. 

(message code=x'67', JES3 job nuaber=0102, normal completion 
code=x'00') 

lATPURG Intercoms - S JESAID,01C2x'CO• 

lATADJP writes as a CTC console message - x•67’0102x'00' 

If JES3 job number 0102 completed abnormally, the following is sent: 

(message code=x'67, JES3 job number=0l02, abnormal completion 
code=x'01') 

lAIPORG Intercoms - *S JESAID,0102x'01' 

lATADJP writes as a CTC console message - x'67’0102x'01' 
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installation planning 


The aigration aid provides a viable aeans of selectively processing ASP 
jobs in a JESS environment while maintaining the integrity of the jobs 
in the ASP queue. Only those resources required by the selected JESS 
processing options (such as consoles or unit record devices ), and used 
during job execution (such as tapes or disks) need be committed to the 
JESS processor. 

Both ASP and JESS function as independent systems. The aigration aid 
does not attempt to present a single system image, control the use of 
shared resources or provide control card and JCL compatibilty between 
the two systems. Jobs selected for transmission to JESS may also be 
processed through some or all of the ASP Scheduler Elements once JESS 
processing is complete. Therefore, consideration should be given to 
provide compatible job oriented initialization options for both the ASP 
and JESS systems if compatibility is desired. The following functions 
must be considered for compatibility between the ASP and JESS systems 
for jobs that are processed using the aigration aid. 


OUTPUT SEEVICE 


SYSOUT Card Defintions; 


The SYSOUT class defined to JESS is prcpagated to the ASP JES when 
output is returned via the JESAID writtr. To provide similar processing 
of SYSOUT output, under JESS or ASP, the SYSOUT CLASS definitions should 
be the same. 


Example: 

The following is defined to both ASP and JES3, therefore SYSOUT data 
processing cn either system is the same. 

SYSOUT,CLASS=A 

The following cards define the same SYSOUT class but with different 
characteristics for each system. Therefore, output will not be 
processed in the same way. 

JES3 - SYSCUT,CLASS=C,TYF5=PUBCH 
ASF - SYSOUT,CLASSIC,TYPE=PRIKI 


DEVICE Names: 


JES3 output service queues SYSCUT output for processing by the JESAID 
writer if the jobs origin is "ASPSYS" and no destination is specified or 
an invalid JES3 destination is specified or ''DE3T=ASPSYS" is specified. 
Therefore, only those support devices that phystcally exist on the JES3 
system need be defined to JESi. The names associated winh the JESJ 
support devices should he the same as in ASP to eliminate changes to ASP 
gob decks or could be unique names defined only to JrS3. 
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Exanples: 


The following job is submitted to JES3 via the migration aid. SYSPHINT 
is returned to ASP for processing. 

//ASPJOB JCB ,AABDVARK 
// EXEC EGH=ACCCUST 
//SYSPPINI DD SISOUI=A 

The following job is submitter, to JES3 via the migration aid, 

//ASPJOB JCB ,AAEDVARK 
//*FORHAT PH,CEHAtlE=SYSPFl:;r,DEST=BM001 
// EXEC PGM=ACCCONI 
//SYSPRINT ED SYSOUT=A 

If HM001 is defined to ASP but not to JES3, SYSPHINT is returned to 
ASP, If BM001 is defined to JES3, SYSPRINT is processed by JSSi. 

The following job is submitted to JES3 via the migration aid. 

//ASPJOB JOE ,AAREVARK 

//♦FORMAT PR,DDNAME=SY£PRINT,DEST=BB001 
//•FORMAT PB,CDNAME = SYSPRI?JT 
// EXEC PGM=ACCOUNT 
//SYSPRINT ED SYSOUT=A 

If RM001 is defined to JES3, SYSPRINT is processed by JES3 and a copy is 
also sent back to the AS? system. If RM001 is not defined to JES3, only 
one copy cf SYSPRINT is sent back to the ASP system. 


MAIN SCHEDULING 


Generalized main scheduling (GKS) job-oriented scheduling information 
(that is, ClASS names) should te defined the same for ASP and JES3 to 
eliminate ASP job deck changes. Processor names (such as SYl) valid to 
ASP but not known to JES3 result in //•MAIN control card errors under 
JES3 for jobs referencing the names. Therefore, //•MAIN cards may have 
to be changed to reference a valid JES3 processor if the job is to be 
processed under JES3. Generic names used in ASP job decks must be valid 
to JES3 to eliminate ASP job deck changes. 


STANDARDS 


Standard job oriented defaults such as FAILURE, FORMS, CARRIAGE, LINES, 
or CARDS should be defined alike for both ASP and JES3 if compatibility 
is desired. 


OPERATOR COMMUNICATIONS 


Proper initialization of the migration aid in the ASP and JES3 systems 
is required to insure the integrity of the existing ASP system and 
permit the CTC communications to be established in the proper sequence. 
Deviations from the recommended initialization procedure may cause 
unpredictable results. 
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The ASPAID CSP should always be i litialized first if CTC data 
coonunication is to be establishe 1 with J£S3. 

Once the ASP CTC coBmunication en'ironuent has been established, the 
JESAID DSP Bay be called in the J :S3 system. 

Termination of the Bigration aid lay be initiated froB either systea via 
a ^CANCEL JESAID or *CANC£L ASPAI J operator coamand, but requires 
operator intervention on both the ASP and JES3 systems to effect the 
complete shutdown of the faciltiy *CaNCEL JESAID, issued first, 
terminates the JES3 portion of th ; Higcation Aid and quiesces the CTC 
support within the ASP system. A subsjquent *CANCEL ASPAID effects the 
shutdown of the migration aid facility within ASP and the rescheduling 
of jobs queued for JES3. A *CAHCEL ASPAID issued before a ^CANCEL 
JESAID terminates the ASP portion of the migration aid and causes all 
JESAID functions to be quiesced in the JES3 system. A subsequent 
♦CANCEL JESAID is required to complete the shutdown of the JESAID DSP in 
the JESS system. 


JES3 COMMANDS 


The JESAID reader queues jobs received from ASP for the JESS internal 
reader. Therefore, an internal reader must be active to permit jobs 
transmitted from ASP to be entered int< the JES3 system. To start an 
internal reader enter: 

*X INTPDB 

Similarly, the JESAID writer queues rerouted output for an output 
service writer but does not dynamically schedule the writer. Therefore, 
a writer may have to be started tD process rerouted JESAID SYSOOT data. 
To start a writer, enter: 

*X WTB,uuu ..uuu=device specified as the JESAID alternate 
destination. 


♦ CALL 

♦X JESAID,[CIC=unit address] 

[,BDB={STCP| (STABT,reader name) )] 

[,HTB={H0LD|STABT|STCP1({STABT|STOP, 
alternate destination)))] 

unit address - identifies the CTC adapter address used by JESAID to 
communicate with the ASP systea. The unit must be defined to the 
global JES3 processor as SYSTEH=ASPAD in the JES3 initialization 
deck. Ho attempt is made to communicate with the ASP system until 
this parameter is provided. Therefore, the writer STOP option may be 
employed to reroute queued SYSCUT data independent of the ASP 
processor status. The "CTC" must be defined to JESAID only once and 
may be on the ♦CALL or a subsequent ♦START. Once defined, it remains 
the active CTC device until JESAID is canceled by the JES3 operator 
or is quiesced via an ASP operator cancel or JESAID failure. 

START - activates the JESAID reader or writer function. Cnee started 
they remain active until a STCP or ♦CANCEL is issued. 

STOP - deactivates the reader cr writer function. Jobs normally read by 
an active reader will remain ASP system. SYSOOT data 

sets queued for the JESAID writer will be redirected tc the alternate 
destination cr deleted if no alternate destination is specified. 
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HOLD - signals the JESAIi, writer to terminate transmission of SXSCUT 
data to ASP after the active data set is complete. All other output 
will remain queued for the writer until a subsequent SIABT or STOP is 
issued. 

alternate destination - a 1-8 character name that is used as the JES3 
output destination for writer data sets that cannot be successfully 
transmitted to ASP or whenever the writer is in a stopped state. The 
default is no alternate destination which will result in the data 
sets being deleted. Any valid JEE3 device defined as "D1YPE=PBTxxxx" 
may be used as an alternate destination. SYSOUT output rerouted to 
the alternate destination is printed using installation standard 
forms, carriage, train, etc.. 

reader name - the name assigned to the JESAID reader via the DEVICE card 
in the JES3 initialization deck. The GEOUE name associated with this 
JHAHE becomes the CHIGTN for all jobs read by the JESAID reader. 


*STAET JESAID - (All parameters valid for the JESAID "CALL” are also 
valid here.) 

Additionally, a "*S JESAID,STATUS" results in the issuing of message 
IAT1930 indicating the current status of all JESAID functions. The 
"STATUS" request may be included on the same *STAai that contains 
other JESAID parameters but should always be the last parameter 
specified. Any parameters following the STATUS parameter are 
ignored by JESAID. 

Examples: 

*S JESAID,BDR=STCP,STATUS .Valid 

*S JESAID,STATUS .Valid 

*S JESAID,STATUS,HDB = SIOP .BDB=STOF will be ignored 

*BESTABT JESAID - used to reinitialize the CTC and the active 

reader-writer functions after an ASE or ASEAIE restart if JESAID is 
active. This command should only be used when requested by the 
ASPAID DSP. 

♦CANCEL JESAID - causes the termination of all JESAID functions. A 
cancel transmission will be sent to the ASE system to effect the 
shutdown of the active CTC functions in the ASP system. 


ASP COMMANDS 


♦CALL 
♦X ASPAID 

[,CTC=unit-address] [,NAME={sysname | JJS } ] 

[,CLASS={job-class|(job-class 1,job-class2,...,job-classn)| 

/job-class 1/ (job-classi,job-class2,...,job-classn) J ] 

[,GROOP={job-class-group 1(job-class-group 1,...,job-class-groupn) | 

/job-class-group I/(job-class-group 1,...,job-class-groupn)J] 

[,{OHG|OBIGIN }={origin|(originl,origin2,...,originn) ) ] 

[,{N|H0BMAL)={A|01C)] [,{J|JCBFAILJ={A|0|C ) ] [,{S|SYSFAIL}={B|A101C } ] 
[,{DI DISPLAY }={£iASS|OBG|OBIGIN )] 

♦X ASPAID - used to iiitialize the ASPAID DSP and allow input service to 
start the selection of jobs that are to be transmitted to JES3. 

unit address - identifies the CTC address used by ASPAID to communicate 
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with the J£S3 systei. 

sysname - a 1-8 character naee used to idenv.ify the JIS3 systea for 
coBMunicatioDs purposes. 


Job selection paraaeters: 

CLASS - defines the class of jobs that are -.o be transaitted to the JES 
systea. 

GBCOP - defines the job-class-group-naae that is to be used to deteraine 
the class of jobs that are to be transaitted to the JES3 systea. 

ORIGIN - specifies jobs to be selected for transaission to JES3. 

DISPLAY - displays the CLASS (es) or ORIGIN (s) currently being used for 
job selection. 


Post-J£S processing paraaeters: 

NORMAL - defines the action to be taken for a job that completes on the 
JES system. 

JOBFAIL - defines the action to be taken by ASPAIE for a job when JES 
returns a job-fail code for that job. 

SYSFAIL - defines the action to be taken when ASPAID is notified of a 
JES3 system failure or when ASPAID is terminated. (Reference 
♦RESTART and ♦CANCEL ASPAIL) 

The job selection and processing paraaeters aay be overridden by the 
JESOPT parameter on the job's //•MAIN card. 


♦START ASPAIE - (All parameters valid for the ASPAID call are also valid 
here. The CTC and NAME paraaeters will not cause any action to be 
taken if previously specified.) 

START is used to initiate the scheduling of jobs that have keen 
selected for transaission and, or subsequently, to modify the ASPAID 
parameters. The scheduling of jobs is started on the start command 
following the command in which the CTC is specified. Until this 
sequence of commands is issued, jobs will only be queued for JES 
processing. All modifications for selection and failure criteria 
must be communicated in this Banner. If the CTC rarameter is 
specified on a START command, a subsequent START ccamand aust be 
issued to initiate scheduling. 

♦RESTART ASPAID - used to reinitialize the CTC communications with JES3. 
All jobs that have been transaitted will be processed according to 
their SYSFAIL option. This aessage should be issued when it is 
desired to reinitialize the migration aid, normally after a JESJ 
system failure that necessitated a JES3 COLDSTAHT. The ASP operator 
will be prompted to start/restart JESAID. 

The issuance of a RESTART causes an ASPAID cancel transaission to be 
sent to the JESS systea. If issued after a JES warmstart or during 
normal operation it aay cause goes to be run twice on the JES3 system 
(SYSFAIL=E) and/or output data sets for jobs to be incomplete on the 
ASP systea. 

The single exception is if module AIDADAP fails and is quiesced by 
ASP FAILSOFT. The issuance of an ♦RESTART ASPAID under these 
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circumstar.ces «ill effect the reinstatoent of nodule AIDiDAP and the 
restoidtion of the ligtation aid status, within ASJe, piioc to the 
failure. 

♦ CANCEL ASPAII - causes the tetBicatioi) of the ASPAID function. A 

cancel transmissicn is sent to the JSS3 systen to alert JESAIE that 
the ASPAIE functions are terminating. All jobs sent to JES3 are 
processed according to their SYSFAIL option, except that jobs having 
the P (reschedule JI5) option have their JES Si marked complete and 
are processed according tc the.r JOBFAIL option. 


KESSAGES 


JE33 FEOCZSSCP 


1^11900 JESAID ACTIVE 

IXPLANATICN: The JZSAID DSP is ready lor operator input and is 

proceeding with the processing of paraoeters on the "CALL". 
OPERATOR RESPONSE; None. 


IAT190J unit address IS AN INVALID JESAID PROCESSOR 

SiPLANATION: A CTC address specified in a "CIC=xxx" operator request 

was'iict defined during JSS3 initi^lization as "SySTSH=ASPAD" and cannot 
be used as a JESAID "CTC" device. 

SSSIAIQS_ES5i21J“I! Reenter request using valid CTC address. 


IATJ9C2 unit address IS ALREADY J CTIVi 

EXPLANA TI ON: The CTC unit addresi; indicated is currently initialized 

for JESAID communication with the ASP system. JESAID supports a single 
CTC interface to ASP and all subsequent *STAHT CTC= requests are 
rejected while a given interface s active. 

OPERATOR RESPONSE: None. 


IATJ903 INVALID OPERATOR BEQUEST "text" ...REENTER 

EXPLANMION; a tarameter entered on a vCALL or *STAHT is in error. 
"Text” indicates the keyword associated with the error or the 
non-keyword in error. All subsequent parameters specified are ignored. 
OPERATO R RESPON SE ; Reenter request via ♦START or issue ♦CANCEL to 
terminate. 


IATJ904 "text" TRACE DISPLAY 

£1£L^NATI0N: An invalid CTC operation has been detected. The "text" 

contains a trace of CTC operations. 

SfERATOR_RESPONSE; Verify that the ASPAID function is active and the 
CTC has been properly initialized in the ASP system. ♦CANCEL JESAID on 
repeated occurences of this message. 


IAT1905 TEHHINATICN IN PROGRESS 
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B^P LA MA TION ; In response to the JESS operator issuing a *CAHCEL or 
*BESTART or a CANCEL transmission from the ASFAID DSP, all JESAID 
functions are being terminated. 

OPEBAT OH HESPOy SE ; If due to an ^CANCEL, by the JESS operator, no 
operator response is reguired. If due to an ASP operator *CA]ilC£L or 
^BESTABT of the ASPAID DSP, all active functions will be quiesed and 
JESAID will wait for a *STABT or *CANC£L from the JESS operator. 

Note: Any attempt to reestablish CTC communication with the ASP system 
when the ASPAID DSP is not active will cause unpredictable results. 
Therefore, unless ASFAID is active, *STABT JESAID requests should be 
restricted to writer rerouting options and vRESTABT should not be used. 


1111906 JESAID TEBHINATED 

EXPLANATION: JESAID has terminated processing due to a JES3 operator 

♦CANCEL. 

OPEBAT OB R ESPONSE; None. 


lilJiiiil HEADER {ACTIVATED IDEACTIVED J CHIGIN=nane 

EXPLANA TI ON: The status of the JESAID reader is as indicated in the 

message. 

OPERATOR BESPCNSS; None. 


lATJlSps {READER IBRIT2B} PROCESSING CCBFLETE FOR JOE number/name 

EXPLANA TI ON: Reader - The transmission of a job from the ASP system is 

complete and the job has been queued for the JES3 internal reader. 

Writer - All data sets currently queued for the job indicated have been 
transmitted to ASP or requeued for another JES3 output service writer or 
deleted. 

OPERATOR RESPONSE: None. 


1111909 READER IS NOT ACTIVE 

IllilllllCN: A ''RDH=STCP" has been issued and the reader is not 

active. 

OPERATOR_RESPCNSE : None. 


IATJ9JP READER IS ALREADY ACTIVE 

EXPLANATION: A "REH= (START,name)” was issued and the reader is already 

active. 

OPERATOR RESPONSE: None. 


11119J1 RESTART HEJECTED...CTC IS NOT ACTIVE 

EXPLANATION: *HESTAHT can only be issued after the CTC has been 

activated via an *STAfiI CTC=unit address. ♦RESTART should only be used 
to reestablish CTC communications with \SP after an ASP system or ASPAID 
restart if JESAID CTC communications ar i not queisced. 

2£ESA10R_RE£P0NSE : If communication wi ;h the ASP system is desired, 
issue an vSTAET "CTC=uDit address" for the JESAID DSP. 


1111912 WRITER { ACTIVAt’E! I DEACTIVATED I iELDI STOPPED ) ALTDEST={ name 1 NONE ) 

EXPLANATION: The status of the JESAID »riter is as indicated in the 

message. NONE indicates no alternate destination. 
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QffPlIOK_BESFCNS£: Socfe. 


JA1J9J3 name CANNCT £i USED AS A JESAID RSADSP DEVICE 

^XgLAN^SISS5 The device name specified in a RDH*(STAaT,naie) operator 
request is offline or not defined as a JESAID reader device. The JSSAIC 
reader device must be defined in the JiS3 ini^i lization deck as 
''DTYPE = AID'' and "DGBCUFsASPSyS". 

C|iP»T0R_P2SPCSSE; Vary device online to JF£ . .v specify valid JESAID 
reader device name. 


liiJiJii {beaeesiheiteb) baitihg fob {BOBKICTC} 

SafiLlMliSU 1 Po jobs are currently queued for the indicated processing 
or the CTC is not curently active. 

0EERATCB_BES£CNSI: If data transmission with the ASP system is desired, 

and“the"message~Indicates "WAITING FCE CTC", issue "START for CTC=unit 
address; else, no operator action is required. 


IM1515 WRITES IS SOT ACTIVE 

EXPLANA TI CS; An operator request to alter the current writer status was 
issued and the JESAID writer was never started. The writer must he 
started before it can be stopped cr held. 

SlIRMOP-ilSPCNSE; Issue a "STABI "BTB=STAHT" JESAID request and then 
alter writer to desired status. 


name IS AN INVALID ALTERNATE DESTINATION 

EXPLANA TI ON: The alternate destination specified in a writer start or 
stop request is not a valid "PRT" device. 

OESBATpR_BESPONSE; Beenter request using a valid alternate 
destination. 


IM.19J2 WRITER ACTIVE FOB JOE nuoiher/n-' 

EXPLANA TI ON: The writer has found the data set(s) queued for the job 

indicated and is proceeding to process th?a. 

OPERATOR BESPCNSE: None. 


{OPERATOR I EBRCB) REBCOTE JOE ni,;uner/naae 

EXPLANATION; The indicated job has been requeued for another output 
service writer :.r d^^leted based on the optional destination status 
because the write, is "STOPPED". Else, at i-- or has been detected 
during writer processing for the job indicated. ALL data sets have been 
requeued for another output service writer or deleted based on the 
optional destination status. 

OPERAT OR RESPONSE: None. 

Note: Repeated errors may indicate ( 1 ) jobs were not submitted via the 
the JESAID reader cr (2) the jobs no lon^ -ist in the ASP queue or 
(3) the jobs status has been altered by the ASP operator and are no 
longer active in the ASPAID SE. 


liSJSJi CTC CUEISCE COMPLETE ON ONIT=naae 

tiL- CTC communirations are terminateo due to an ASPAID cancel 
or a c erator "CANCEL or "HESTAiil i-equesL. 
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OPEBAIOB BESFCBSE: None 


IiIJ220 NO BESPCNSE BECEIVED CN UHIT=U!.it address 

: The CTC aldress specified is not responding to JESilD 
initial cic transnissioa. 

OfISAI2S_S1££2S51! Verify that the correct procedure was used to 
initialize ASPAID and J2SAID. 4>CA1ICEL i<ESAID on repeated occurences of 
this nessage, reinitialize the CTC coantnications on the ASF processor 
and recall JESAID. 


1121921 BAITING FOB BEIDER/WEITEB/CTC (PTIONS 

llfilflllON: No JESAIE functions are currently active. 
QllRATOBllispCNSE; Enter VSTABT JESAID with desired operands or »CANCEL 
to terminate JESAID. 


112J922 CTC INITIALIZATION COMPLETE ON 0NIT=unit address 

SlfLllilllSR: OTC communications have been established with the ASP 

system. 

OPERATOR BESPCNSE: None. 


111.1923 ASPSIS GROUP DEVICE OHAVA CLAELI 

IlfL1112ION: The writer did not find ai online device defined as 
"DTYPE = aId'* and "DGROUP^ASPSIS". 

OPER1|OE_RESPCNSE: Vary a device online with the appropriate 

characteristics or if none aie defined to JES3 notify your System 
Programmer. 


1121924 PERMANENT I/O ERROR 0NIT=unit address 

EXPLAN AT ION: A permanent I/O error has occurred on the CIC device 

Indicated. Recovery will be attempted by restarting the current 
function. If recovery fails, JESA D may be quiesed. 
QfIRATOR_RESPONSE: None. 

Note: Repeated errors nay indicate a hardware problem. 


2121925 JOBS QUEUED FCR READER 

IlfflNATICS: Jobs are available in the ASP system for input to JES3 and 

no JESAID reader has been started. 

OPERATOR_RESPONSE: Start a JESAID reader if inputting of jobs is 

desired. 


2121926 JESAID QUIESCED BY ASFAID CANCEL 

IlfilNATICN: All active JESAID functions have been terminated due to 

the cancelation of the ASPAID DSP in the ASP system. 

QPERATOR_RESPONSE: Issue a •CANCEL to terminate or ♦STARI with desired 
options after ASPAID is restarted in the ASP system. 

1111927 JESAID QUIESCED BY JESAID FAILURE 

IlfilNATION: A program failure caused all active JESAID functions to be 

terminated. 
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2i:2HiI6i‘.i!S£P&NS£: Is^sue »CAMCEL t: termanate or ♦STaR'I with desired 

Of , 

IsIJiio JOE jot number PURGE WAITI.^G fCB CTC 

Oil; The 30 b indicated has coBfleted JES3 processing and the 
jot purge message is queued waiting for CTC initialization. 
O^iEhiOS-SSsiONSZ: Issue an '"»s JE^AIC,CIC=unit address" if 

ccimunicaticns with the ASP system is desired. Else, no action is 
required. 

Note: Queued termination messages ire purged if JESAID is canceled 

before the CIC is initialized. 


lATJ9i9 JESAID QUIESCED..INVALID AjP RESQUEUE 

hi£LANATION: After a JES3 cold start, and during CTC initalizaticn, 

gob (s) were found in the ASP BQ that had previously been transmitted to 
the JESS system. This indicates an improper migration aid 
initialization procedure was used. All JESAID functions ate guiesced 
and message IAT1921 is issued. 

S£ERAI0R_HESP0NSE : (ref. message IATig21) 


CTC[A ID ),unit name REH[A ' B ],origin name 
NTR{A IDIHIS},alternate de: t 

E^PLANATICN: Ihe current status of the JESAID functions are as 

indicated. A - Active, D - Inactive, H - Held, S - Stopped 
QPERAT0R_SESP0NSE : None. 


ASP PROCESSOR 


lilJiSSjl 'text' invalid 'explanation' [message ignored] 

hAIJ.AII.QN ■ A tarameter entered on a CALL or START is invalid. 

• Re-enter the correct parameter (s) via START or issue 
CANCEL to terminai-e ASPAId. If 'message ignored* is appended to the 
message all of the input has to he re-entered, otherwise only the 
parameter i,i error has to be re-entered. 


IAIJi52 CTC unit-address (xxx) not defined as ASP real main. 

AljATION: The CTC unit-address in the CALL has not been defined as 

an ASP main or, if so defined, has not been defined as a HEAL main on a 
MAINPROC initializ e non card. 

OPERATO R RESPONSE; Check the CTC address entered. If incorrect 
re-enter the correct unit-address on a *S ASPAID command. If correct 
contact the system programmer. 

PROGRAMKER_RSSPONSE: Select Other CTC address for migration tool or 
restart ASP with fiAINFEOC for real nrocessor desired. 


1*11224 ASP MAIN (xxx) online 

: Ihe main selected as a migrut... tool is online to iSP as 

a real main, 

2P£B.AT0H_]1ESPONSE: Vary the MAIN oifline to ASP and notify ASPAID via 
the START c;; iaand. 
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Iklllia {JOBS|IJP|ACDS} active on ASP HAIM selected for sigration. 

EAPLANA TIC H; Jobs are active on the sain selected, or UP or ACOS is 
active for the main selected. 

OfgBATOH RESPONSE; Cancel the jobs or functions active on the sain, or 
allow then to complete and notify ASPAIO via the SIABl command when the 
main is quiesced. 


ASPAID initialized - job selection for migration started 

EXP LA N ATION : ASPAIC has been initiali::ed and jobs that meet migration 
criteria are being selected and queued for migration. 

QSIMIOB-BESPCNSE; When the JES system is active - issue a START ASPAID 
to begin job migration. 


I AT1 956 ASP-JES3 migration active 

£1£LANATI0N: Job migation has been started to the JESS system. 

SIliiToOlSPONSE: None. 


IATJI957 ASPAID ACTIVE. Job scheduling for migration started. 

EXPLAN ATI ON; In response to an operator * START command the ASPAID CTC 
communications task has been started and JSS has been posted to start 
the scheduling of jobs queued for migration. 

OPERATOR RESPONSE: None. 


ASPAID TERHINATION IS IS PROGRESS 

E^PhAMSISN 5 In response to the ASP oj.erator issuing a *CANCEL ASPAID 
command, all ASPAID functions are being terminated. All migrated jobs 
will be processed according to their SYSFAIL option. 

OPERATOR RESPONSE: None. 


1M1959 ASPAIE TERMINATED 

IIPhANATION: ASPAID has terminated prccessing due to an ASP operator 

♦CANCEL. 

OPERATOR BESPCKSE: None. 


IaSISSO ASPAID RESTART PEOCESSINI CCMlLETS - STABT/BESTART JESAID ON 
JES.SYSTEM 

EXPLANA TI ON: In response to the VSP operator issuing a ♦RESTART ASPAID 

command, ASPAID has processed all jobs active on the JES system 
according tc their SYSFAIL option and las re-initialized AIDADAP. 
AIDAEAP is waiting for an initial tran:mission from JESAID. 
OPEEATOE_RESPCNSE: Notify the JE.! operator to START/BESTABT JESAID to 

re-establish communications. 


JESAID terminated by JES operator. 

EXPLANATION: JESAID has be-n canceled by the JES operator. 

SYSTiM.ACTIQN: ASPAID will wait for ♦CANCEL or *HESTART from ASP 

operator. 

0PFRAT0R_RE5rCNSE: Enter ♦CANCEI ASPA D if the migration function is to 

be termlnat cdT'^Enter ♦RESTART A5i.'AID f JES is to be COLDSTARTED. If 
JESAID is restarted no operator ectioc is necessary. 
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>^ 0 ^ asp-job-nunbet { ACTIVE|CCBFLETE J oa JES3 as jes-jot-number 

• ACTIVE- The transmission of the job to the JESS system is 
complete." COMPLETE - The jcb has completed JESS processing and all data 
transmission for the job is complete. 

OfSIMOS-IISICNSS: Ncne. 


IITJ963 ASPAID I CLASS | CEIGI.J ) table 

{empty|{job-class 1 , 2 ...n|cri 3 in 1 , 2 ...nj] 

• The CLASS or ORIGIN migration selection criteria consisted 
of the class (es) or origin(s) specified. 

OPERATOR RESPONSE: None. 


1*11964 AIDADAP FAILED - restart ASPAID to refresh or cancel ASPAID 

EXPLANATION: AIDADAP, the ASPAID CTC I/O handler has failed. 

gpiiATOR_RESPONSE: Enter *EESTART ASPAID to refresh AIDADAP and restart 

migration processing, or enter ♦CANCEL ASPAID to terminate migration 
processing. 


Message received from JES for JES job jes-job-number invalid. 

EXPLANATION; A job started or completed message mas received for a job 
unknown to ASP from JES. This may occur as a result of a non-ASP 
submitted JES job specifying OHG=ASPSYS or an improper sequence of 
♦RESTART ASPAID/JESAID commands. 

0PERA30R BESfONSE: None. 


IAT1966 INVALID OPERATOR REQUEST 

EXPLANA TION : An operator message was directed to the JESS processor and 

is rejected. 

OPERATOR RESPONSE: None. 


I*T1962 RESQOEOE INVALID..ASPAID RESTART PROCEEDING 

After a JESS cold start, transmitted jobs were found in 
the ASP RQ and ASPAID restart processing is being performed. 
OiISATQI_l$SPONSE: None. 

Note; ASPAID must be restarted or canceled whenever JESS is cold 
started if jobs previously transmitted to JESS had not completed JESS 
processing. 


ASPAID message accepted 

EXPLANATI ON ; The last command entered has been processed by ASPAID. 

This message will only be issued when the operator command did not cause 
any other message to be issued. 

OPERATOR RESPONSE: None. 


3AT1969 JESS SISMSG {STAHTIEND} 

This message delimits t ie JESS portion of the SXSHSG file 
printed by ASP to better define that jutput generated by ASP and JESS. 
OPERAT OR RESPONSE; None. 
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lilJii "etc trace" 

E]{ PL ftN AT ION: AIDAEAE trace. "etc trace" contains a trace of CTC 

operations. 

OFEHATOR BESPOHSE: Kcne. 


VAB90 migration-system-name (5IGBATICII TOOL. CANNOT BE VABIEE ONLINE ON 
SOPPOBI 

EXP LA NA TI ON: The aain specified on the vary counaand is active as a 

■igration aid and cannot be varied online as an ASP nain. 

OPERATO R RESPONSE: Nc response is necessary if the aigration tool is to 
reaain active. If the main is to be ised as an ASP main, then enter 
♦ CANCEL ASPAIE and after ASPAID has t< rainated vary the aain online. 


ISV92 JOB joh-naae CANNOT BE SENT TO JES. 'text' 

IX£iA nation ; 

• The job is a non-standard gob and there is insufficient room to add a 
SE for JES in either the JCT or JD B. 

• The job's //*MAIN card migration request cannot be honored since the 
aigration aid has not been called. 

SySTEM_ACTICN: The job is placed in < perator hold. 

OPERAT OR RESPONSE: Release the job fer ASF execution, cancel the job or 
notify the programmer to determine action to be taken. 

PROGB Ai5!lER_EE£E0NSE: Notify operator to release the job for scheduling 
on the ASP system or to cancel the jot and resubait the job when the 
migration tool is activated. The job cannot be held for migration since 
the migration selection is only made during input service. 


ISV93 JOB SELECTED FOR BIGRATICN TO . ES3 

jo^ been selecteil for migration to JES3 based on 

job class, jot origin, or the JESCPI ; arameter on the //♦BAIN card. 

SySTEa_ACTION: The job will be scheduled to be sent to the JES3 
system. After executing on the JES3 system, of if the migration aid is 
canceled, further scheduling on the A'P system will be dependent on the 
system default or programmer options specified. 

This will be the last message in SiSB:G if the aigration aid is canceled 
prior to the job being actually sent ■ o the JES3 system and the jcb is 
canceled with output. 


JSS09 JOB joh-naae CANNOT BE SENT TO 1ES. ASPAID CANCELED. JCB HELD. 

SiPLANATION: The specified jot that had been selected for JES 

processing cannot be scheduled for JE5 since the ASPAID function has 
been canceled. 

SYSTEB AC TION: The job has its JES SI narked complete and is placed in 
operator hold. 

OPERATO R RESPONSE: Release the job for ASP execution, cancel the job or 
notify the programmer to determine action to be taken. 

PSOGRABMER_RE£PONSE: Notify operator to release the job for scheduling 

on the ASF system or to cancel the jol and resubait the job when the 
migration tool is activat<d. The job cannot be held for migration since 
the migration selection i: only made < uring input service. 
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JIS3 PROGaAMjSIJiS SQriS AJD RZSTHI gyi CSS 


The folloifing are proaranaing notes and restrictions for the J2S3 (732 
Release 3} user. 


gBOGHA HHING jgOTES 


ACTI7ATING J2S3 STANDALONE DOHPS 


St and a lon e Daijg Fo raatting 


Module lATABPB executes as a user exit routine to the 0S/7S2 service aid 
prograa AKDPHDMP. It serves as an interface between AMDPRDMP and the 
JSS3 duap formatting routines to produce printed control blocks from a 
rav core laage duap. 

Module lATABPR is reenterable. To improve performance when printing 
core image dumps with AMDPHDMP, it is recomaended that lATABPR reside in 
the pageable link pack area. 


C ontrol Sta tem ents 


Module lATABPR processes two additional control statements as input to 
AHDPRDMP: JES3 OFF and JES3 DEBUG, 

JES3 O FF — This control statement causes module lATABPR to bypass 
processing of any JES3 control blocks for the duration of the job step 
initiating AHDPRDMP. This aid is intended to enhance the performance of 
AMDPHDMP when either the core image dump does not contain a JES3 
subsystem to be formatted or when JES3 control block foraatting is not 
desired in the printed output. 

JES3 DEB UG — This control statement enables data collection to assist 
in problem solving in the event of a program check during format 
processing of JES3 control blocks. The aES3 DEBUG statement allows a 
snapshot dump (ID=77) to be written to the JES3SNAP data set. The 
snapshot contains registers at the time of the snap and the storage 
occupied by the failing module followed by the storage occupied by the 
AE3CSSCT work area. Important registers convey: 

• R11 Address of lATABPR work area (DSECT ABMXTN mapped by lATYXTN) 

• HU Address of formatting work area (DSECT ABNCSECT mapped by 
lATYABN) 
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aes saqes 


j Seven aessayes are i^ossible dutiLj lATABPR processin*;. They are written 
directly to the AMEPErMP PRINTER data set at the tiae the conditions 
that irovoke the aessage is encountered. 

{EXCESSIVE OUTPUT CUEiNG JE3J FORKATTISG IN Bodule-naae| PROGRAM CHECK 
DURING JES3 rOFhAmSG IN aoaule-naae| POSSIEuE LOO? OF J2S3 FORMATTING 
IS aodule-aame } 

Expla na ti on: Excessive output (more than 3K) lines, a program check, or 

excessive time (more than 3 minutes) was detectea while acdule-name was 
in control. The ?S« and registers at the time of failure are also 
printed, followed by the mooule ID referenced by base register 10 at the 
tiae of failure. 

Sys te m Act ion; Continued processing is attempted with the next 
formatting module. 

Pro gra m mer R es p on se: If the message is accompanied by unsatisfactory 
dump output, rerun the gob with a J5S3 OFF control statement to bypass 
JES3 formatting. 

Prob le m D etermination; Rerun the gob with a JES3 DEBUG statement. 

Table I, items 1, 5, 13, 22 
Module: lATABPE 


SNAPSHOT FAILED DURING JES3 DEBUG HODB 

Exp lanatio n: The 0S/VS2 macro SNAP failed to produce output during a 
JES3 DEBUG interval when an unexpected return code was encounterea. 
System Act i on : Continued processing is attempted with the next 
formatting module. 

££2:1E§1S!S£_S§§£2S§§ ■ Make sure the gob step includes a JES3SNAP DD 
statement. It may be necessary to increase the REGION size for 
execution of AMDPRDMP. 


JES3 PSRFOSHANCS-AID CDE AREA SRROR-FOBKATTING MAY EE SLOilD 

Expl an a ti on: An invalid address was encountered while obtaining CDE/XTNT 
list data from VS control blocks (that is, module names and their extent 
addresses). The table is marked incomplete and may or may not impact 
the speed of JES3 dump formatting. A longer lookup method is used when 
a name or address does not exist in the CDS table during JES3 MEMORY 
OSAGE formatting, FCT formatting, or trace table formatting. 

Sys tem Action : None. JES3 dump formatting continues. 

Pr ogrammer Respons e; The most likely cause of this condition is the dump 
does not contain the area with a needed CDE or extent list (partial dump 
or the area was previously destroyed before the dump). If this 
condition is persistent on several different dumps, the problem is 
likely to be an internal error in formatting module IATABN7. 

Pro blem Determinat ion; Table I, items 4, 7, 16; Table III, item 7. See 
OS/VS Meisaie Library: ilSl Messages, GC38-1012. 

ModuieT'lATABN? 


JES3 PERFORMANCE-AID DSP AREA OVERFLOW-FORMATTING MAY BE SLOWED 

Expl anation : Too many DSP names exist in the JSS3 DSP Dictionary to fit 
in the JES3 dump formatting performance-aid DSP table (capacity is 140 
names). The table is marked incomplete and may or may not impact the 
speed of JES3 dump formatting. The DSP table is used to obtain DSP/MPC 
names during formatting of FCIs and trace table entries. Names are 
obtained by a longer lookup method when they do not exist in the DSP 
table. 
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^*one. JES3 auap formatting continues. 
i:£23£2Sie£_S£e£2IlSS: None. The internal table capacity of 140 entries 
has been exceeded. Performance may cot be appreciably affected in nost 
cases. 

Problem Determination: Table I, items 4, 7, 16; Table III, item 7. See 
Qi/VS Messdiies Library: JESJ Messages, GCi8-1012. 

Module: iAXAi3«9 


JZ33 PZHFORMANCE-AID CD2 A3ZA OVEEFLOh-FORMATTING MAY 3E SLOWED 

Explana ti on: ico many CLE names exist on the JOS PACK OUSOE to fit in 
the JES3 dump formattiria performance-aid CDE table (capacity is iiO 
names). Ihe table is marked incomplete and may or may not impact the 
speed of JES3 dump formatting. The CDE table is used to obtain module 
names/entry points during formatting of JES3 MEMORY USAGE, FCTs, and 
trace table entries. tiames will be obtained by a longer lookup method 
if they do not exist aH th^ CDE table. 

Syst em Acti on; None. JES3 dump formatting continues. 

Program mer Response: None. The internal table capacity of 230 entries 
has been exceeded. Only reducing the number of names on the job pack 
queue will circumvent this condition. Performance may not oe 
appreciably affected in most cases. 

Pr oblem De term inat ion: Table I, items 4, 7, 16; Table III, item 7. See 
Qj/VS dessges Library: JSS3 Messages, GC38-1012. 

Modul9:”lTA3N7 


J333 PERFORMANCE-AID NOT AVAILAELE-FORMATTISG MAY BE SLOWED 

Expl an a ti on: The GETBAIN for a performance table of 3ft8b bytes failed 
during JES3 formattinj. Formatting continues, but reverts to "normal" 
mode which may have an impact of noticeably slower dump formatting of 
JES3 control blocics. 

slliSl Ac tion: None. JZ33 dump formatting continues. 
?rograamer_ae3pgnse: Limit the virtual storage region size so PRDOMP 
does not usurp all of virtual storage for use as buffers. This 
limitation can he imposed by using the REGION keyword on the JC3/EiEC 
statement. For t-xample, //DUMP JOB RSGI03 = 2')6K will limit th“ buffer 
area to 2o6K, and leave a sizeable residue for module loading and fixed 
length GZTMAINS. 

: Table I, items 4, 7, It; Table III, item 7. See 
Messages Lgbrary: JES3 Messages, GC3d-1012. 

Module: I..TA3.;7 


JiE3 FCSBATIENG PE RFOh MANCE-A ID FOR AENGET DID NOT INETIALIEE 

ji££±dF:^t ion: The lateAnal buffer management could not be activated. The 
buffering fancticn reverts to "normal" mode to continue formatting. 
Impact IS a .higher decree of CPU overhead. 

Sl§tem Action: None. J£53 dump formatting continues. 

££ 2 a£^SlSE_Sesionse: The IATAEpR formatting module driver for JES3 could 
net locate a key comparand in PRDBP modulf' routine AMDPRRDC, or the key 
buffet map entry did not contain a JES3 ACID. The most likely cause of 
the problem is that JES3 module lATAap” is operating as an exit routine 
to an incompatible version of AHDt'RDMF . Sake sure the versions are at 
compatibl ’ prognm levels. Only the CPU speed of formatting is affected 
ay this condution. 

££2hifcl‘ Deter minaticn: Table I, items 4, 7, 16; Table III, item 7. See 
Ln/'ii. -ISSsjaiS Dihrdty: JEGJ GC3b-1012, 
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ABZND IJSSH=77 

Expla nation ; A ptogran exception occurred during JES3 fornatting that 
could not be processea as expected. Addressing to essential work areas 
was lost. 

Sistem_Action: The AMDPHDM? job step is abnormally terminated, with a 

dump written to the SiSOEUMP/sySAEZND data set. 

Pt 03 rammer_Bes£onse; To obtain a complete dump from AMDPR3KP, it will 
be nece^ary to rerun the gob witi. a JES3 OFF control statement. 

Problem D etermination: Table I, items 1, 5, 13, 22 


QE Activating lA TAE PR 


Module lATABPR executes as a user exit to AMDPRDMP. The service aid 
program becomes aware of user exits by entries in a module named 
AMDPRECT, which resides in SYSI.LIilKLlB. The method for activating a 
user exit is explained in Setting Up the ECT in the section for the 
PRDMP User Exit Facility (see Appendix C in OS / V5 2 Service Aids, 
3C28-0674). The appropriate AMASPZAP input is: 

REP Offset C9C1Z3C1C2E7D940,80000000 
RSP offset+OC D1C5S2F340404040 

which translates to: exit to module lATABPR on any TCB being formatted 
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OE on any JESJ control stateaent verb. 


ASP3.1 TO JS£3 CCMIBCL CABD CCNSICEBAIICNS 


BsiSiistioM/I§£2i£§iifeiiiii§§ CiSij.i is jes3) 

• Although the ACMAIS and ACBOLD paraseters on the //^MAIll card are 
still alloved, an additional, acre flexible function has been 
provided on the //ofOBBAT card, naaely the «AIS and HOLD paraaeters. 
The following FOBKAT card would perfora the identical function that 
is available via the MAIH card: 

//•FOBHAl AC,DD8AHE=, HAIS=aain-naae, HODD=YES 

By Boving these paraaeters to the FOHMAT card, the TSO user can 
select by data set which onjs he wishes to see at this terainal. 

• The creation of Foraat Paraaeter Buffers (FRP) and the aethod with 
which the data is added to thea has changed froai ASP3.1. In ASP the 
use of the //oFCEMAT card caused all fields in the FBP to be filled. 
If a paraaeter was not specified the default standard was used, Ho 
consideration as to whether the non-specified paraaeter had teen 
defined on a default FCBMAT card (where DDNAflI=, was specified) or on 
the sysoOT initialization card for the SYSOUT Class Table. The FBP's 
in JES3 are filled in the fallowing sequence: 

1. //•F0B8AT card for this data set 

2. JCL paraaeters on the JCL rtateaent for this data set. 

3. SYSOOT Class Table entry for the SYSOUT class of this data set 

4. Default FBP resulting fto« a //*FOBMAT EDHAHS*, card 

5. JEE3 defined standard. 

only if a paraBeter is not specified in the first four sources is the 
JES3 standard used. 

• Any job that uses 0SIT= (CTC,,riFSR) to reference a data set created 
via the //♦DATASET card aust be ran on an ASP {HVT or TS2/1) Main 
Processor. The ONIT= (CTC,,DEFEB) will not be supported by the 
Converter/Interpreter and Global/Local {M7S) Processor. 


A job Bay be run on any processor and access a card iaage (coluan 
binary) data set by using the JES3 supported MCDE*C DCfi parameter on 
the DD card. If MCEE*C is used cn the DD * stateaent, it aust be the 
only parameter following the ♦ or DATA. The data set aust be 
terainated by a /♦ when the MODE=C paraaeter is used. Therefore, the 
card must be: 

//ddnaae ED ♦, DCB*MCDE=C 

input Service adds to each ED ♦ or ED DATA card •BCB=BEKSIZE=80». If 
MCEE=C was specified, ELKSI2E will be set tc 160. Also, for a job 
containing card image data, the reader (CB) aust be called with the C 
parameter (that is, •]£ CB,Z). 

• Any DSF specified on a //*P30C£SS card must be defined in the JES3 
DSP Dictionary as processable. Any job specifying a DSP that is 
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defined as not pcocessable will be flashed. 

• JESilSG, JESJCL, JOUBN&L, JCELOCK, JESInnnn are new ddnaies used by 
JES3 and are added to the list of other reserved ddnaaes used by iSF: 
SYSMSG, JCBIN, JCBIiB, and JCLIM. 

• If SEQCHK=YES was specified on the SYAHDAHDS initialization card 
under ASP, Input Service would sequence check input object decks. 
Since the CS Linkage Editor perforas its own type of validation, this 
function was reaoved froa the JES3 Input Service. 

• Due to the new aethod of reading data by the readers (CB, IB, and 
DB), the naxiauB blocking factor for input to TB and DB is now 40. 

The aaxiaua for CB reaains five. 

• H0TJ0B=I£S specified on the //*IiAIN card of jobs scheduled to run on 
a Global or local (MVS) Processor w .11 be ignored. This paraaeter 
will be honored if the job is scheduled and run on a ASF sain 
processor. 


Bestrp ctj ^ons Bejoysd jASgj..1_t 9 , JES3I 

• The continuation punch in coluae 72 is no longer required to continue 
a JES3 control card. 

• The liait on the nuaber of //•FCBMAT cards per //•FBOCISS card to the 
size of a JES3 buffer has been .ceaoved. 


£25£ai§iii±by Consideratigns (ASF3.1 is 21^3) 

• Use of the //•PBOCESS BICOSTL is still permitted and will be 
converted to RI internally. 

• //♦PROCESS PRINT, PUNCH, or ACES Will still be allowed. The first 
one found will be converted to //*PBCCESS CUTSEBV. Any others of 
these three laaediately following the first will be ignored and will 
be flagged as such. An intervening //*PBOCESS card of another DSP 
followed by one of these three will cause a new //*PHOCESS CUTSEBT to 
be created. These three DSP's are grouped in this aanner since all 
will be processed by Output Service under JES3. 

• The /♦ prefix used in ASP Versicn 2 will still be supported for those 
ASP control cards otginally supported under that systea. 

• The //*ENDPROCESS card is no longer supported. It will be treated as 
an OS comaents card. 


DEFAULT UNIT PABAHETEB 


If a dynamic allocation is made on behalf of a time-sharing user without 
specifying a unit paraaeter, the unit parameter is obtained from the 
time-sharing user attribute data set (UAD). If the user is not a 
time-sharing user or if the UAD's entry does not contain a unit 
paraaeter, a KVS default of 'SYSALLEA', that is, all direct access 
devices, is used. 

It is recomaended that a default unit parameter value be defined in the 
UAD and that all dynamic allocations specify a unit parameter. 

Otherwise, the MTS default unit value of 'SYSALLDA' must be included in 
SETNABSS for all DA device types if JES3 is to manage the dynamic 
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allccdtions tr,at dc net have a unit paiaoeter. 


DI£ PCUTISES IN FLEA 


It is recpaiuended that the disabled interrupt exit (DIE) routines, 
lATDMES and IAIS5DI, be located in the fixed link pack area (ILPA) 
rather than in tne ELEA. These tve routines will nornall^ ne 
paje-fixed, vbich mil result in over-utilization of real storage in 
PLEA. 


DYNALLOC CAHD 


JCL CD statenents are no longer valid for describing the various 
procedure libraries under JES3. Instead, the CYNALLCC card in the JES3 
initialization deck nast be used. This is necessary in order to allow 
the dynamic unallocaticn/reallocation of procedure libraries during 
procedure library update jobs. The format of the DYNALLOC card may be 
found in the Initialization and Tuning Guide manual. 


INTEBE PABAWETZH ON STANDARDS CARD 


The following describes the optional INTEBE parameter on the STANDARDS 

initialization card: 

:NTEHP=[ AHJf^l ANYftSPIEOTB] 

Whenever £i£IEll*ANi has been s-ecified for a given job, whether on 
the //♦MAIN card or by default to the system indicated on the 
STANDARDS card during initialization, a decision must be made as to 
whether the CS Keader/Interpreter or the VS Converter/Interpreter is 
to process the JCL for that joJ• A user exit capability in Input 
Service will be provided to al cw the user to determine under which 
system the jcb is tc run. However a default must be provided if that 
exit routine has not been provsded by the user. The INTSRP keyword 
provides such a default. 

ir INT£EP=AN¥JES (the default), the job will be processed for a VS2 
rH' Lionment. ANYASF will cause the job to be processed for an MVT or 
VS2 release 1 (ASP MAIN) environment. INTERP=BOTH indicates that the 
job should be processed in such a manner that will allow it to be 
executed in any cnviro.naent, the final decision being left to Main 
Service. However, since a significant amount of overhead is 
associated with the latter cas€, due to the necessity to process the 
jet through both the VS Converter and the CS Reader, its use is 
strongly discouraged. Besolut on of SYSTEM=AN¥ by the user, via the 
user exit, is to be preferred. 

Note: There is no //♦MAIN ovej ride for the INTERP value set at 
initialization since it is only used when a SYSTEM=ANY situation 
cannot be resolved. 
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JES3 BODULES LISK-iEIT AII8IB0IES 


All JES3 nodules are link-edited with the following attributes; 


LET 

NCAL LIST 

XREF 


addition. 

the following 

modules have 

the 'BEUT' 

attribute. 

lATOMDK 

lATOSDI 

lATSIST 

lATGSCI 

lATIIRC 

lATDMEB 

lATSIBS 

lATSIVL 

IATIIAM 

lAIIIRM 

lATDMFR 

lATSICA 

lATSIWO 

lATIICA 

IATUX04 

lATIIFD 

lATSICF 

IATSI34 

lATIICC 

IATUX05 

lATIICX 

lATSICN 

lATSSCM 

lATIICM 

IATUX06 

lATDHDM 

lATSIDM 

lATSSDl 

lATlIDR 

IATUX07 

lATDHDS 

lATSIDO 

lATCXOl 

lATIIPR 

IATUX08 

lATIIII 

lATSlDR 

IATUX02 

lATIIPO 

IATUX09 

lATIMDL 

lATSIJS 

IATUX03 

lATIIPl 

lATUXlO 

lATIIRX 

lATSIOP 

IATUX26 

IATIIP2 

lATUXll 




IATIIP3 

IATUX30 


PAGES EAEABETEH CN THE EOFIER INITIlLIZATION STATEMEST 


In selecting the size of the buffer pool using the PAGES parameter, 
consideration should be given to the fact that all functions might be 
active at the same time. The buffer pool should therefore be 
allocated to cover the worst case, since the buffer pool is not 
expandable after initialization. In addition, since JSAH page 
releases 4K blocks when they ate no longer in use, it is advantageous 
to make the buffet pool as large as possible since very little 
penalty is incurred to make the pool large and the system is better 
able to accomodate bursts of activity. 


PEBBANEHTLY HESIEEST MOEULES 


For modules not already permanently resident, JES3 uses a counter to 
determine the number of times a module has been loaded and deleted. 
Once a module has been loaded b times it is marked as resident and 
subsequent deletes are ignored. A module's resident threshold count 
can be dynamically altered using a JES3 *Hodify command. 


IJSTBICTICNS 


CATALOG BEFEBENCES 


Utilities which establish entries in a catalog can not be executed as 
a step of a job which contains JCL references to those entries. 
Dependent Job Control (DJC) can be ised to execute the utility as a 
separate jot. 

A catalog entry made as a result of the DISF=CATLG parameter on a ED 
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stateaent can be ccfetenced in a subsequent step of the saae 30 b 


COKPLEIICS COLE ENLISG IN '22' 


Although abnoraal termination occurs, a corresponding dump is not 
provided by the operating system if the completion code specified 
ends in a '22'. (for example, S122, S322, S722, etc.) 


INITIALIZING JES3 FBCM A CABD BIADEB 


Bhen initialization is performed by reading statements in from a card 
reader, initialization statements that precede the JIS3 I/C 
statements are not available for printing when the JES300T data set 
is opened. 


JES3 MODULE NAMING CONVENTION 


JES3 modules created by the JES3 user (user-written DSPs) must 
conform to the standard naming convention established for JES3. That 
is, the first three characters of all JES3 module names must be lAT. 


JCECAT AND STEPCAT DATA SETS 


In order for JES3 tc perform pre-execution setup for JOBCAT and 
STEPCAT data sets, units on whici these data sets ate to reside must 
be JES3 managed devices (that is, the unit must be defined on a 
SETNAHES initialization statement) . 


JOB NUMBEBING AFTE 8 A BESTABT 


After a restart, the internal nuibering of jobs resumes with the next 
available number not assigned to an active job or job in the queue. 
This means that it is possible t^ restart with a job number assigned 
prior to the restart if that job had been purged after the last 
checkpoint taken prior to the restart. 


PBCCEDOBE LIERAHX UPDATE FACILITY 


Procedure library data sets (designated by lATPLExx DD cards) can not 
be concatenated data sets. Each procedure libary data set must be 
specified in the initialization deck by a DYNALLOC card, and must be 
cataloged in the sytem catalog. Prior to update of the standard 
procedure library (lATPLBST), an initiator must already be active on 
the global machine. 

All procedure library update jobs must run on the main processor 
designated as JGLCEAL. 


JES3 Programming Notes and Bestrictions 87 



SPECIFZIH6 THE UNIX PABABEIEB BXTH a TILOGEC EATA SETS 


At the tiae JES3 resolves catalog re;ere&ces, there is so eaj to 
deteraioe whether the OBIT specified is a subset of the uait type 
referenced. If the user specifies a unit that is incoapatible with 
the cataloged data set (such as a data set on a 2314 device with a 
nNIT«3330 specified), then JES3 will flush the job. 


SISOOT BLOCKING 


sysoOT block size liait is 32767 and is independent of JES3 buffer 
size. Actual blacking of data is transparent to the user. 
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OBDSRISG, DISTBIBUTION, AMD PUBLICATIONS SUPPORT 


ORDERING PROCEDURES 


To order J3S3 as an independent coaponent of 05/VS2 Release 3, contact 
your I3K representative or the IBM Branch Office serving your locality. 
It is no longer necessary to fill out a Program Order Forn; your IBM 
representative places the order for you. 

An 0S/VS2 Release 3 Starter System is required for initial system 
generation. 


distribution £RQCSDUR£S 

JSS3 IS distributed on magnetic tape only. The number of user tape 
volumes required is specified in the basic and optional material lists 
which follow. 

JES3 basic machine-readable object code is distributed in SUP format. 
J3S3 optional material is distributed as a SYSIN data stream compatible 
with the lEBUPDTE utility program. 


SASIC PROGRAM M ATER IAL LIST 

You get one copy of machine readable material consisting of the JES3 
Distribution Library. Order the basic program material by selecting one 
of the following feature numbers. 

SSSDer T ra ck/Den si ty Num ber of Ta£e Volu me s 

5039 9 track/1600 BPI tape None (DTR) 

5040 9 track/6250 BPI tape None (DTR) 


OPTIONAI. PROGRAM MATERIAL LIST 

You can optionally order one copy of JES3 source code and JES3 macros. 
Order the optional program material by selecting one of the following 
feature numbers. 

F eature NaiSei Track/De nsi tv Numbe r of Jape V ol umes 

5428 9 track/1600 BPI tape 1 

5429 9 track/6250 BPI tape 1 
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£J2£iil£iUSSS SiifPQBI SI USI 


The following publications contain specific infocaation about JESJ and 
are used in conjunction with othec publications that support 0S/TS2. 


eiifisiaa aad iisisigntiM a S£S3 3yste> 


£as£ Qiisi iiail>s£ ifclic^^le tils 

Introduction tc JSS3 
0S/TS2 Systea Prograaning Library: 

Initialization and Tuning Guide 
0S/7S2 Systea Prograaaing Library: 

Job Hanageaent 


S£§£§£ias S SISJ Sys t ea 


Title 

Operator's Library; 

0S/TS2 Reference (J3S3) 
Operator's Library: 

0S/ys2 fieaote Terainals (JLS3} 


SISi ijQfc Afitiications 


lAlie Bass Sldfil £9!bS£ i££lisa&i£ IfliiS 

OS/7S2 JCL GC28-0692-1 GI28-2600 


Ease Order Byibgr Afiflisa^ls IRLs 


GC38-0226-0 

GC38-022d-0 


None 

None 


GC28-0607-0 

GC28-0681-1 

GC28-0627-0 


None 

GH28-2603 

GN28-2601 


££2£lSa Cs£S££indiisn 


£as 2 S£Sa£ l!ailia£ Acflisa^lg 


0S/?S2 Bessage Library: 

JES3 Bessages GC38-1012-0 lone 

0S/yS2 Systea Projraaaing Library: 

JES3 Debugging Guide GC28-0703-0 None 


Ba j-ntenapce . Bod if icatisB» as3 S§g£~££i£i£!i PSf ? 


Iliie 

0S/TS2 Systea Prograaaing Library: 

JES3 Bacro Instructions 
0S/?S2 JES3 Logic 


£asa S£dfi£ lyiii££ 

GC28-0608-0 

SY28-0612-0 


afi£li£i£ls Ills 


None 

None 
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